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PREFACE 


This manual describes privileged surervisor call (SVC) facilities 
and other operating system features intended for use Ly system 
programmers, system analysts, designers, engineers, and training 
instructorse 


Charter 1 presents an cverview cf the orerating system and the 
software it sugrorts. Charter 2 is a auide to writing executive 
tasks (e-tasks). Chapter 3 explains how tc use SVC 0, SVC 2, and 
SVC 7 tacilities. Chapter 4 contains a functional descrirticn cf 
the SVC interception feature recently develcped fer 08/32. The 
uniform vertical forms ccntrcecl (VFC) feature is descriked in 
Chapter 5 along with cther device inderendent and dependent 
features. 


The OS/22 System Level Frogrammer keference “anual is one cf 
three manuals replacirg the CS/32 Pregrammer Reference Manual. 
New features described in this manual include VFC and SVC 
intercerticn. Chapters 2 and 3 were fermerly Chapters 7 and 8 cf 
the OS/22 Programmer Reference Manual. 


This manual applies to the CS/32z FC€ software release ard higher. 


The following manuals can be used in conjunction with this 
manual: 


FURLICATION 
KANUAI NAME NUPBER 

OS/22 System Macre Library Feference Manual HE-ODE 
32-Eit Systems Software User Documentation 

Summary Ye-O75 
OS/i2 Ureratcr fKeference Fanual uF-O3C 
OS/322 System Generaticn (SYSGEN) Reference 

Manual 4 B-937 
OS/i2 Supervisor Call (SVC) Reference Manual ue-0 38 
OS/22 Azrplicaticn Level Preogrammrer Reference 


Manual 48-0395 
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For further inftcrmation en the centents cf all Perkin-Elmer 
32-rtit software manuals, refer te the 32-Bit Systeme Software 
User Documerntaticn Summary. 
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CHAFTER 1 
O$/32 AND SUBSYSTEMS 


1-1 INIRODUCTICN 


Perkin-Elmer 98/32 is a general purgose, event-driven oprerating 
system fcr Perkin-Elmer 32-bit ccmputer systems. CS/322 is 
generated into a system threugh a system generator program that 
provides barameters Lor tailoring O0S/32 te a specific 
installation. The comtined hardware and software capabilities 
provide suprort fcr all phases cf fregram and system develorment. 
OS/32 suUpperts concurrent multirrogramming, with up to 252 user 
tasks (urtasks) written in any cf the supported languages. The 
program develorment features minimize the time and effcrt needed 
to test, derug, and integrate arplication programs and systems. 
The operating system can be tailored to support a wide variety cf 
configuraticns, ranging from small dedicated systems to large, 
multipreccessor, shared memory systems. O£/32 alsc supports a 
command language that allows complex jobs to be perfecrmed with 
minimum operator interventicn. 


OS/32 incorforates a powerful interrupt hendling capatility at 
the task level. This capability permits a task to be interrupted 
during its rormal executicn sequence hy a variety of hardware ard 
software conditicns. 


The roll function, surported by OS/32, allcws total memcry 
requirerents eof (rollable) tasks within the system to exceed 
available task memory. Fecrtions of a task that exceed availatle 
task memory are rolled cut to disk until memory is available. In 
real time applications, rolling is commcnly used to queve lcw 
pricrity tasks while tasks cf higher priority are active. The 
roll eligitility of a task is estaklished when linked; however, 
a task cpticn is provided to prevent roll of a task when 
necessary; e@ege, when the task must te atle to respend tc real 
time events. 


A basic data communications facilities rackage is supplied with 
OS/32. This grackage alsc provides sursort for higher level 
Perkin-tlmexr data communications preducts. 

The score and pewer of the oreérating system can be extended 
through these GS/32 comranicn products: 


o BMulti-Terminal FKonitecr (MT) 


re) keliance 
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MIM is a suksystem monitcr that uses the suktasking carahilities 
of 035/32 to Provide a tire-sliced, interactive program 
develorment environment fer up to 64 concurrent terminal users. 
MTA sSinultaneously surrerts both online terminal users and batch 
background tasks. MTM terminal users are also rrovided with an 
I/D Spocler for use with slew sreed devices. 

Reliance is a transacticn software system, ccnsisting of the 
Integrated Transaction Cecntrcller (ITC), Vata Management System 
(DMS/32), and industry standard CCPCL. ITC allccates system 
resources, develops screen fecrmats, and controls terminals. 
DMS/32 supervises disk allccaticn and data access. 

12-2 SOETWAKE SUESYSTEMS 


OS/32 ccnsists cf the fcllecwing subsystems: 


o Task Management 

Oo Job accounting 

Oo Memory management 

o Timer management 

o File management 

o I/0 management 

oO Error recording and reporting 
o Memcery diagncstics 

o Loader ard segmentaticn 

o Easic communications 

o Conscle nonitcr 

o Command frocessor 

o System iritializaticn 

o Internal interrurt 

o Opticnal user superviscr calls (£VC) 


o Floating point 


Table 3-1 stmmarizes the scftware errrported by CS/32. 
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TAELE 1-1 PERKIN-ELMER OS/32 SOFTWARE SUPFORT 
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TaSx Nanagemert 

Jcb accounting 

Memory managenent 

Timer management 

File ranagemert 

I/O management | 

Error recerding and reporting 


| | 
| | 
i { 
| | 
{ | 
| | 
| Memory diagncstics | 
| | 
| 
| | 
| | 
| | 
| | 
| | 
{ | 


Program 
Develop- 
ment 


Leader and segmentaticn 

Censole moniter 

Cemmand processcr 

Floating foint 

Internal interrurt sutsystenm 

*Integrated transacticn centreller (ITC) 
Writakle contrel store (WCS) 
Multi-terminal mcnitcr (TM) 


} Data Pase | *Lata Management System (P€S/32) | { x 
} Manage-~ | | ! 
{| ment | | | 


Data 
Communi- 


| Asynchroncus data communicaticns 
| - 

{ cations 

i 

| 

| 


| | 
| Character synchronous communicaticns | 
} &it synchroncrs cemmunications | 
|} 2785/378¢C RJE emulaticn | 
} 3270 emulaticr | 
{ HAS?P/ 32 | 


Languages | Ccmmon microccdé assembler (“ICRCCAL) | 
{ Common assembly lanyuage (CAL) | 
| CAL macro | 
}] FCRIRAN VI1 Levelcpmert (T) Language | 
| ©£CRIHAN VII Cetimizina (C) Language | 
| *COBGL | 
| asic Level I] | 
| Ccral 66 | 
{ RFG ITI ! 
| Pascal | 


Utilities 
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| | 
| | 
| Text | 
} Scurce Updater I 
| AILS (Automatic Interactive febugging | 
|} system) | 
} Ccry | 
| Library lcader | 
| Macro library | 
| Sert/Werge II i 
| Patch | 
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* ITC, CCSOL, and [M%S/32 comrrise the Perkin-Flmer Reliance 
system designed for transaction pregramminga. 


1-2-1 Task Management Subsyster 


The task management subsystem provides all the functions required 
to schedule, cocrdinate, and surervise user aprlications. Task 
scheduling is provided on a8 user-defined rriority hkasis that 
determines tne crder in which each task gains control of the 
processcre Tasks at the same priority level are serviced cna 
round-rcbrin basis, which can orticnally use time-slicing to limit 
the executicn of any one task. 


OS/32 recognizes 255 pricrity levels frem a high of 1 tc a lew cf 
255- Of these levels, 10 through 249 are available to u-tasks, 
while 1 through 9 and 250 throuch 255 are reserved for system 
use. Each task can be given three rriority levels: 


re) Maxintum 


o Dispatch 


Maximum pricrity, set by Link, is the highest priority level at 
which a task can be assigned.» Task priority is the priority at 
which a task is currently assigned. Initially, task pricrity is 
set by Tink but can be rodified as a result of command executicn. 
A daispatched task usually has a priority level equal to its task 
pricrity; hcwever, if a higher rricrity task requires specific 
system rescurces keing used hy the current dispatched task, the 
dispatched task priority can be raised so that it can complete 
executicne 


If a tatk in control of the CPU has the same priority as an 
incoming task, the CPU task remains active until it relinquishes 
control cf the processer.e Friorities should be assigned soc that 
tasks that require a large amcunt cf rfrocessor time de not lcck 
out other tasks. 


A task will relinquish control cf the processor to another task 
whens 
o it is paused by the system orerator; 


o it is cancelled ty the system oreratcr, user, or by another 
task3 
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o 4 higher pricrity task btecomes ready due to an external event, 
such as the completicn cf an outstanding I/9 request; 


re) it executes a macro call that places itself in a wait, paused, 
cr dcrmart state; or 


re) it initiates I/0 to a devices. 


Rather than being scheduled on a strict pricrity basis, tasks can 
be time-sliced. This orticn allows tasks of ecual priority to 
receive equal shares cf processing time. The operatcr ccmmand 
SET SLICE enables or disables the time-slicing ocption. When a 
task becomes ready, it is queued on a round-robin basis tehinrd 
all ready tasks of €qual priority. 


The task manager maintains three chains to facilitate task 
scheduling: 


re) Rollin chain 
re) keady chain 


fe) Wait chain 


The rollin chain is a queuvé containing a list of tasks to te 
rolled inte the system and put on the ready chain for executicn. 
The task manager removes tusks from the rollin chain and places 
them or the ready chain in gpriocrity crder. Specific wait 
conditicns must first be satisfied tefore a task is remcved frem 
the rollin chain and put on the ready chain. 


The ready chain is a queue containing a linked list of task 
control bliccks (TCB) that are ready te execute. A task must te 
removed from the rollin chain cr wait chain and added te the 
ready chain before it can te dispatched for executicn. Only 
tasks or tne ready chair are eligible fcr execution. The ready 
chain is maintained accerding to task priority. The task with 
the highest pricrity is moved te the head of the ready chain and 
dispatched for executicn. Tasks are scheduled for execution cn 
a first-in/first-cut (FIFO) basis within each priority level. If 
time-slicing is enabled, the task at the head of the ready chain 
relinquishes ccntrcol when its time expires, or if an equal cr 
higher gricrity task is ready. If no equal or higher pricrity 
task is ready, the task at the head of the ready chain continues 
to execute tor another time-slice.e. If time-slicina is disabled, 
the task at the head of the ready chain continues executing until 
it voltntarily relingvtishes control cr until a higher pricrity 
task becomes ceady. 


The wait chain is a queve centaining tasks that are in a wait 
state. These tasks require the ccempleticn of external events; 
@eGe, 1/0 crererations, before execution can be resumed. While the 
task is in the wait state, the task manager handles task queue 
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entries using the task queue service method and also evaluates 
all pending and wait ccnditions. /ffter all external events are 
Satisfied, the task is ina ready state and is returned to the 
ready crain at the rprorer rpricrity. 


The task manager bperfornss machine state changes thrcugh routines 
that Switch or Exit tasks from cne machine state to another. 


The task manager also performs context switching by saving the 
contents of registers intc an alternate save area and exchanging 
the task status word (TSW). © 


12.2.2 Job Accounting Subsystem 


The job acccunting subsystem provides infeormation such as _ CEU 
usage, elarsed time, utilized memcry and disk space, and number 
and length cf I/C transfers by device class. The jck accounting 
subsystem cecntains the: 


re) Data collecticn facility 


re) ACCOtnt reporting utility 


The data ccllection facility ccllects accounting data on all user 
activities that cccur ir the system and stores informaticn in the 
accecunting transaction file (ATF) when the task terminates. 
Reports can be requested for individual user accounts, summaries 
of user accounts, and systen usage. The account repcerting 
utility is sritten in Ferkin-Elmer FCRTPFAN VII and is desiqned to 
readily allow implementation cf specific custcmer site 
requirenents. The performance data collected ty the data 
collection facility is frerared by the account repcerting utility 
for use by system maintenance rersennel. 


Threugh the DISELAY ACCCUNTING command, the system operator has 
access to accourting data fer cne cr all tasks in the syster. 
1223 Kemory Management Subsysten 

At load time the mencry management subsystem dynamically 
allocates Epace for user and system aprlications. There are two 
types of menory: 

re) Local 

o Global 


Local memory is physically contigucus startina from Ilccaticn 0O 
and contains the operating system, task space, and system space. 
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Global memory is located atecve local memory and is not required 
to be contiyucus. This area is shared by global task cemmcen 
segments. If glcbal menmecry is located in multiport memery, it 
can be chared by more than che froceéesSSoOre 


Memory is allocated on 3 first-fit tfasis when sufficient memcry 
is available for a specific task. Free segments are allccated in 
ascending address crdere when no space is available fcr a task, 
the memcry manager determines which tasks are tc be rolled cut to 
ensure that high priority tasks take frecedence. When wmemcry 
becomes free, adjacent areas are merged tosether tc minimize 
search time and to provide larce free blocks of memory for tigger 
tasks. System task space is alse maintained by the wmemcry 
Manager and is dynamically allocated when a task er device 
Structure is built. 


The menory manager maintains task space through = free and 
allecated lists. Segments are allocated dynamically cn the 
first-tit basis by searching the free lists. When free task 
Space is allocated to a segment, it is removed from the free list 
and ccnnected to the allocated list. Similarly, whenever a 
Segment is released, its memcry space is removed from the 
allocated list and connected to (or merged into) the free list. 


1-2-4 Timer Management Suktsystem 


The timer manayement sutsystem rrevides u-tasks with a set cf 
timer fmanagemert/maintenance services. These services centrcl 
all time dependent functions; €e96, time-slicina, I/0, jcb 
accounting, tile dating, through the universal clock. 


The following timer quevtes are maintained by the timer management 
subsystems: 


o Time of day 
Oo Device timecut 
re) Commtunications device timecrt 


ce Interval timer 


There are several timer rcutines that service these queves. 
Entries are placed on the time of day queue and the interval 
timer gteue aS a result cf surerviser call Zz (£VC 2) timer 
requests. The control klocks cn the time of day queve are 
referred to as timer queue elements (TCEsS). The interval timer 
queue has the same format as the time of day queve tut is 
maintaired as a Separate queue. 


The universal clcck consists of a line frequency cleck (LFC) and 


a precision interval clcck (PIC). The LFC generates an interrurt 
every €.3 milliseconds cr 1279 times rer second. The FIc 
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interrurts when a task*s requested time interval has exrired cr 
at intervals of 4095 milliseconds, whichever is shortere If the 
interval terminates or the time of day is reached, the TCE is 
removed from system space and an aprrorriate trap is generated. 


1-2-5 File Management Subsystem 


The file management subsystem ccordinates the disk file 
requirements of all tasks. The file manager allows u-tasks to 
operate with disk files in a device inderendent fashion. In 
addition, the file manager rrovides disk derendent facilities. 


Perkin-Elmer 32-bit computers suprort a wide variety of disk 
devices ranying from the 256kb florpy disk te the 256™r (MSM300) 
disks. CS/32Z distingtishes tetween permanent and temecrary 
files, treviding a temgcrary file facility for scratch work. Two 
file types are providei-by the OS/32 file manager: centigucus 
and indexed. 


To ensure the integrity cf informaticn stored on disk, the file 
Manager interleéeaves disk access reauests from different tasks Ly 
using tile access protcccls. 

The file access rotcccl is a 5-stage precess, providing 
Operaticnal tlexibility at all rhases of file usage. An 
abbreviated protcecol is used for terrorary files. I/O calls to 
these files are autcmatically intercepted by the file manager. 
All I/C operaticns to files or devices are done to logical units 
(lu) rcather than tc a specific device cr file. A file cr device 
Must be assigned by the user tec an Ju by a command, macrc, cr an 
SVC 7 pEricr te an I/0d operaticn. SVC 7 file management handieér 
provides the following interfaces te the user for file/device 
Managements: 

Oo Allecaticna 

re) Assicnmeart 

o Chance acceSs privileges 

Oo Renaming tfilé€és 

re) Reprctecting files 

o Closing files (deassignment) 

o Celeticn 


o Checkpeirting 


© Fetch attributes 
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1.2.6 I/0 Subsystem 


The I/cC subsystem prevides a unifcrm programring interfeéce 
between the task and external devices. I/C cperations can cccur 
in the tfollcwing task mcdee: 


fe) Wait~only - executicn i: halted until data transfer is 
completed. 


o Froceed I1/0 - task ccntinues executicn during data transfer. 
o Halt I/0 - allows the task te recall proceed I/O0 requests. 


o Uncorditional preceed I/C - task connects immediately tc an 
I/0 device. 


2 fueued I/0 - task continues executing even though more than 
one proce#zd I/v calls are outstanding. A task trap meckhanisn 
reports each completed. I/93 oreraticn individually. Wait-cnly 


and test I/7cC functions allew the task to synchrenize its 
execution with the ccmpleted I/S cperaticns. 


1.27 Error Recording Subsyster 


The errecr recording subsystem records on disk all internally 
logged errers, Ereviding a data Fkase fer the Frror Reperting 
Utility. This utility analyzes the reccrded data and generates 
reports. 


Of/32 memory errer recerding sceftware supperts the memcry errcr 
lea hardware of the Perkin-Elmer 3260 Series machines. Frrer leg 
hardware keeps a history of the single bit corrected memory 
errorse Tne operating system reads the errcr Jeg hardware ard 
stores the errer infcrmation inte an internal errer lcg buffer. 
When tne error log bufter is full, its contents are stored cn  4an 
errer recerding file with the date and time of the last errcr 
reccrded. when the errer recercing file is almost full, a 
warning message is displayed on the system console indicating 
that a new error recording file should te allocated or that the 
Error Reperting Utility shculd te initiated. The Error Repcertifrg 
Utility provides Yrererte on the rrevicusly recorded errcr 
informaticn in the €rrer recording file. 


The current errcr status can be disrlayed te the syster ccnecle 
by using the CISELAY EFFORS cermmand. The internal errer leg 
readout period can be chanyed Fy the system operator. 


1-2-8 Memory Diagnostics Subsystem 
The memecry diaynostics sutsystem eliminates inoperable memcry 
areas frem the system cenfiguraticn without affecting task 


executicn. It enables the operatinoe system to execute with part 
of real memory removed (holes) or powered down for maintenance 
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purpoS¢&e ‘eaMory is tested, marked on, and marked cff by using 
the oreratcrc FEMORY ccommand and hy the initialization cf the 
operating Syste. 


Tne marked cti aereas are nected in the memcry mar. Memory is 
MacKked on when previously marked off memory is to te used again. 
If an unreccverable mencry errer on any Perkin-Flmer 3200 Series 
machine occurs during task execution, the operating system 
automatically marks off the area cccupied hy the task. 


12.29 loader and Segmentation Subsysten 


The OS/i2 resident loader is resrensible fer Ilcading tasks, 
re-entrant litraries, task ccmron (TCO) segments, and shared 
seymentSe Inese tasks and segments must have been built by Link. 
Each load mcdule yenerated ry Link contains information related 
to the load module, e€e@-3 taetk crpticns, size, lihraries 
referenced. The OS/32 resident louder uses this information to 
generate duata areas, set the task crticns, create seoment tarles 
fer the u-tasks, and mag all the necessary segments of the tasks. 
All u-tasks in CS/32 are built as though they were tc te loaded 
at physical address C in me€emory. Threcugh the use cf the 
relocation/gretecticn hardware, the task addresses are 
automatically relocated at run time tKy using the task sSeqment 
table. Tnis precess is totally transparent to the user. 


The Loader is also resrcnsible for creating the task environment, 
allocating roll files, creating, maintainino, and deleting 
segment tatles, maintaining a seqment control list, and mapving 
and unmapgrinrg shared segments. 


The Segmentation of tasks into rure and imrure segments allcws 
users to Generates multiaccess or multithreading. Regardless cf 
the numker cr times suck a task is required for concurrent use, 
only cre copy cf the pure secment is leaded into memcry ty the 
operating system, whercas an impure seament is loaded for each 
invecation ot the teésk.e. O5/32? assures the irtecrity cf a pure 
segment by using the relccation/rretecticn hardware to give 
read-only accef£S to fFure seaments. Access to task common is 
achieved mnemonicalliy in FORTFAN or assembly rrograms. The 
linkages are resolved ty Of/32 Link, whick also is used to 
request read, write, and execute privileges to task commen. 


1.2210 Basic Data Communications Subsystem 


The basic data communications sutfsystem provides a software 
interface kretween u-tasks and common carrier facilities. Basic 
data cconmunicaticns facilities enahle the user to access remcte 
terminals cr ccmputers as lcecally attached peripherals. Fer 
example, with US/32 Communicaticns there is no difference to the 
u-task ketween lecal teletyrce (TTY) and remcte TITY access. 


In additicn to rfroviding device inderendént (locical I/C) access 
to the u-task, the fsubsyster rprevides a set of mcre basic 
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functions that allow systems to support special procedures, 
terminals, or facilities. Usina the device derendent (physical 
I/O) capability, the system builder can tailor a communicaticns 
package for a particular installaticn. 


This package includes device dependent and device independent 
Support cr aSynchrcnous line devices as well as device dependent 
Support of Linary synctironcus lines. Terminal managers imtedded 
in the software provide high level control for TTY and video 
display units (VDU). 


The OS/32 Basic Data Communications support package is required 
for all 32z-bDit ccecmmurications preducts3 eege, 2780/3780 Remcte 
Job Entry and the ZOPLC Channel Terminal Manager, which surperts 
SDLC, HLLC, and ADCCP prcotccols. 


1.2.11 Console Monitor Sursystem 


The console monitor suksystem rrocesses all I/% requests directed 
to the system ccnsole device ard the system loa device frecm 
u-tasks and frem the ccmmand precessor task. The cconscle driver 
is respcnsikle for interceptina system conscle I/O regvuests and 
for directing them to the console monitor or to anether monitcr 
task such ag MT™M. All I/0 from the system console directed to 
u-taSkKS running under YIM are routed through MIM and nct through 
the console monitor. 


when a commana is issued frem the system censole to the command 
processcr, the console menitcr issves an SVC 6 tc the ccmmand 
processcr nctifying it cf a command to te processed. The ccmmand 
processcr irtergrets the ccmmand and issues an SVC € tc the 
censole moritor indicating that it is ready to accert another 
command. : 


The console driver is a part of the OS/32 I/0 subsystem and is 
the module that intercerts I/9 requests to the system conscle, 
processes them, and gives them to ¥T¥ cr to the console menitcer 
to do tne actual I/0. 


The conscle monitor is the first task dispatched as a part cf tte 
O35/32 initialization hase. Turing this phase, the censcle 
monitor initializes betn itself and the dummy device contrcl 
block ([C8) used by the console driver to intercept requests frem 
the system conscle. The mecniter then issues an SVC € te start 
the comnand proceSscLre 


1.212 Command Processcer Subsystem 
The command preocesscr subsystem accents commands from the system 
console monitor task, decodes them, and calls the arpprorriate 


executore The command rgrecesscr contains lcgic to previde the 
console operator with informative messages in case of errore 
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An extension tc the command processcr, the command sutstituticn 
system (CSS) allows ccnrmcnly perfcrmed operaticns to be executed 
with one commande The CSS routines previde the ability to Euild, 
execute, and control files cf crerator and YT ccmmands. The 
usec e¢stablishes command files that are called frem the user 
console and executed in the user defined sequence. Tn thig way, 
complex operaticns can Le carried cut hy the user with few 
commands. These commands are analogous te macrec instructions in 
assembly language. A set cf l¢gical CSS ccmmands is vrevided to 
control the precise sequence of commands to te executed. 
Parameters can te passed tc a CSS file sc that general sequences 
can be written that take (cn specific meaning only when the 
parameters are surstituted. Cther calls to CSS can be imtedded 
within the CSS file (nested calls). 


The command precessor nermally runs at the second highest 
pricrity level after the censole menitcr in 08/32. This task is 
Strictly trap driven and -respends to the SVC 6 task queue 
parameter calls from the conscle monitcocr to service a ccmmand 
request. aten the command is rrocessed, it sitnals the ccnscle 
monitor tor a new command read via an SVC 6 queue parameter call 
and then suspends itself into a trap wait state. The ccmmand 
process¢tr priority can ke decreased by the cperator ATTN command. 
This might be necessary in a real time arplicaticn environment 
when some other task in the syster has to run at ae higher 
pricrity tnan the ccmmard processcr. 


12.2213 System Initialization Subsystem 

After the operating system is initialized, the system 
initialization subsystem initiates the memory diagnestics and 
error recording subsystems and establishes control bliccks and 
tables in me2mcrye it then dispatches the censcle moniter which 
readies the command processcr te accert commands frem the system 
console. 


1-2¢14% Internal Interrupt Subsyster 


The internal interrupt sybsystem is responsible for: 


o handling illegal instructicn faults, 

o handling arithmetic faults, 

o detecting mencry faults, 

o handling system queve service interrupts, 

o handling protection/relccaticn hardware faults, 
o handling data format/alignment faults, 


o handling power fail and ower restcre conditions, 
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.e) restcring an interrupted task to its srrevicus program state 
upon restmption ci the task, 


re) handling parameter hlcck errers, 
oO nanaling illegal SV¥Cs and SVC interrurts, 
ro) handling unrecoverable machine malfuncticns, and 


O taking memory image dumers. 


Processcr dependent irterrupt handlers basically form the 
interrugpt handler. The internal interrupt subsystem does nct 
SuUPPOrt external interrupts. Fxeternal interrupts are handled 


directly by the appropriate device driver. 


1-.2-15 Optional User SVC Subsystem 


SVC 14 is provided as an ogftional superviscry call that can ke 
defined by the user. Upon execution, the task resumes a task 
trar for SVC 14. 


122-16 Floating Point Subsyster 


The u-task has ceticnal access to single precision and/cr dcutile 
precisicn flvuating point instructions under 18/232. Ficating 
point irstructicns can re executed through hardware cr scftware. 
Those systems that do net sumrfort fFloatina point crticns handle 
ali floating point instructions as illegal instructions. 
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CHAETER 2 
EXECUTIVE TASKS (E-TASKS) 


2e1 <INTRODUCTICN 


Link classifies OS/32 tasks as user-tasks (u-tasks) or e-tasks. 
U-tasks rur with the eretecticn/relccation hardware enabled, 
while é€-tasks run with the proretection/relccaticn hardware 
disabled. Only e=tasksS can add to or modify the system. Fer 
example, additicns can te made ty writing a driver tc suppcrt a 
nonstandard peripheral device, and extensicns can te made ty 
modifying one cr the system modules to include or enhance 
features. 


Also descrited in this charter are extended privileces specified 
through the Link OPTICN command for u-tasks.e. These rfrivileges 
allcw direct task assignment to a disk device and file access fry 
acccunt numter. 


2e2 WRITING E-TASKS 


An e-task, written as a u-task with some additicnal carabilities 
and restrictions, is executed in e=task state by specifying the 
Link OPTION cc TASK command. In e-tesk state, no fprotecticn cr 
memory rcelccaticn is previded; interrupts, excecnt arithmetic 
fault, are enabled; and all machine irstructions and addresses 
are allcwed. 


The system fointer table (SET) rrevides access to system tatles 
and control inficrmation. The address of the SPT is stored in the 
halfword locaticn X°62° in memourye 


2-3 RESTRICTIONS ON WRITING E-TASKS 


pecial care must be taken when writing an e-task. Since an 
e-task can be lcaded intc any area c£ memory and is run with the 
protection/relocaticn hardware disatled, it must he coded as 
positionally independent and must not contain relocatatle cede. 
Therefore, an ertasks 


Oo must not contain RX1 or R¥32 jadnstructicns with relccatakle 
addresses 


re) must not assemble predefined address constants since addresses 
are relocated to absclute zero. For examples 


WN) 
i] 
—_ 
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204 


The data structure macre liktrary is 


SVC7ELK 


must not be 


paraneter 


DB X°B0° ,7 
DAC ATER 


segmented. The e-tack must dynamically set 
blocks; eege, to reference address constants within 
a 1¢krb range, by usirg this technique: 


LA LE, RUFSTART 
LA UF,EUFENL 
LA U3,SVCIPEK 


STs CE,SVC1.SAD(U3) 
S¥C 1,9(U3) 


must use the CAL NORX3 cpticn. Feferences 
range car be made in this manner: 


EASe 


LA U4, BRSE 

LA QDE,BUESTABT-$RASEC( UG) 
LA UF ,BUFEND-PASEC U4) 
LA U3,SVCTPLK-BASEC UG) 
STN UE,SVC1.SE ADC U3) 


SYC 1,0(003) 


DATA STRUCTURE MACEO LIBRAFY 


These nacrces 


> SE eee eee Oe ee eee rome ee eee ees ee eee 


TAELE z-1 CATA STFUCTURE MACRC CALLS USED BY EXECUTIVE 


= = = oe op a ey em ae > GP GD oR © ww en aE er GD Gp am am aw oe wee OO PS Oe OS SS SSB Oe @e ee See 2 2S &@ &S & we 


ee ne ee ee ed 


stored in file 


exceeding a 


its 


1EKE 


SYSSTRUC.MLE. 


are uséd Ey e-tasks. Takle 2-1 lists the data 
structure macre calls fecund in SYSSTFUC.MLE. 


TASKS CE-TASKS) 


Tirectory access ccntrel block 
Channel centrol Elock (CCE) 
Cevice attributes equates 


SFDCB,SOSICR,LDCESECUATE,SPEFLAC,SLATBR,SSDX EFL 
[Tevice desnendent device control bliock (ICB) 


[CB tlacs 
Frimary directory entry 
Tisk extended tlads 


16 executive reaisters (Fi=register 1) 


Event ncde 

File contrcel blicck (FCF) 
FCR and FCa2 flags 

Free blicck descriptcr entry 
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SFFIGS FCE flags 

SFD File descriptor (fd) 

SIGE I/0 tlock 

SIGES I/O and I/C flaqs 

SICEF I/d Elock flags 

SIUk I/O handler list 

SIVI Initial value tatle 

SLIE loader informaticn block (LIE) 
SLIES IIE and loader orticns 

SLOET Icader creticns 

SLSE Icad segment 

SLTCB Icader task control kiock (TCB) redefinitions 
SMACDCB Magnetic tare DCE 

SMS FDCE Mass storage module CCR 

SPDCB Frinary (device inderendent) DCR 
SPFCBR Frivate FCB 


SPsk 
SRECSS 
SRLET 


| 
i 
| 
| 
| 
i 
| 
I 
| 
| 
| 
| 
i 
| Erogram status werd (FS*) 
} SSOPT,SUFEGS,SERFGS,SRRECS,SFESh 
{| Foll seiecticn list 
SRREGS | 16 ygeneral user resisters (81=reaister 1) 
SRSARCFY | Feentrant system state alternate save area 
SSD | Segment descrirtcr element 
| 
| 
i 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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SSOET System orticns 

SSEI System pcinter table (SPT) 
SSPIE SFT extern definiticns 

SSPCL Spooler mressage 

SSVC1 Superviscr call 1 (SVC 1) 
SSVC15S SVC 1 and SVC 1 errer codes 
SSVCIERE SVC 1 errer codes 

SSVC¥ svc 4 

SSVC5 sve § 

SSVC6 SVC 6 

SSY¥C7 SVC 7 

STCE ICB 

STCES STCB,STCIT,SISTT ,STYI,SEDE, and sIors 
STE Timer queue entry (TCR) 

STCFT Task opticns flags 

STS1T Internal task status flacs 
STSh Task status word (TS*) 

STHT Task wait status flags 

SUDI User dedicated lecaticns (UDI) 
SUDIS ULL and Sih 

SUREGS 16 general user registers (Ut=register 1) 
SVL Volume descriptcr 


mn =e SB ON ewe SO ee OO eee eweweweweee See w se eaweOOe Beae wees 2Zewe 2 ee = @ 


2.5 SYSTEM EXTENSIONS 


The operating system can be extended or modified by inccrporating 
changes inte the source of one or more Perkin-Elmer supplied 
system medtles or by adding a user-written system module te the 
systeme All data structures sheculd be referenced by calling the 
data structure (macrce) from the data structure macro library at 


KD 
§ 
Ww 
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assembly tire and by using field definitions in all instructicns 
referencing the structure. 


2.6 TASK ENVIRCNMENTS 


OS/32 provides three task envirenments: 


o Universal 
o Foreground 


o Backsrecurd 


Link assigns a task to a universal environment. Universal tasks 
loaded fron the system ccnscl® can communicate with tasks in the 
feregrcund environment as well as other universal tasks. A 
universal task cannot ce loaded as a background task cr fren a 
multi-terminal monitor (MTM) terminal that has the intertask 
communicatica crtion disabled. 


Foreground tasks have the full range of OS/32 services availatle 
to then. Background tasks are identified when lcaded with the 
taskid .BG. Foregrcund and backgrcecund taske cannot cemmunicate 
with one ancthere 


To prevent ktackground tasks from interfering with foregrcund 

tasks, 4a backgrcecund task is restricted as fclleows: 

o The naximum priority level and system srace of 4 kackground 
task are set at system generaticn (sysaen) time. 

o A backgrcund task cannct ccmmunicate with tasks in other 
environments and vice versa. Intertask communicaticn and 
contrcl functions are treated as norcrs cr illegal calls 


according to the task cgeticns chesen. 


Oo A backgrceund task cannot access task common segments. 
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CHAFTER 3 
SYSTEM LEVEL SUPERVISCR CALLS (SVC) 


3-1 INTRODUCTICN 


This chapter descrites the functicns and capatilities of f€VCs 
used by executive tasks (e-tasks) and rrivileged user tasks 


3-2 SVC 0 


SVC 0 is reserved ter user-written SVC calls. Yocificaticn cf 
the operating system is -necessary in order to write this SVC 
callie 


363 SVC 2 EACILITIES 


Command processcrs are a gart of utility vorograrms and of many 
applications precgrams. Evéry time a preorar is written te accert 
commands, ¢ither Ey ccnversation with an cperator cr Ey ccmmanrd 
Substittticn system (CS&) commands, a command frocessor must 
interpret thoSe commands. “Most command precesscrs are so similar 
that one could te put tcgether frem a canned routine package. 


This chapter guides the user when usina SVC 2 calls previded in 
OS/32 fcr ccmmand processing functicns. 


S636 SVC 2 Code 0: Make Journal Fntries 


SVC 2 ccdé GC makes an entry ainto the system journal frem an 
@-task. The system Icurnal prevides a method to trace kEack 
impcrtarnt events (SVC calls, I/C oreration, task switching) that 
occurred during systen ocoperaticn. The journal is useful fcr 
tracing the cause of a system failure. This is accemrlished 
through the SVC 2 cede C farameter tlcck shewn in Figure 3-1. 


| Value 1 
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| Value 2 | 
| | 
ptepbetatatatenatatetatetatetetatatatettatnatatatateatatetenstenenmaneatentaabentanermereneatetaats | 
}12¢C) | 
| Value 3 | 
| i 
[Saeko es SSS Ste ena en ees Sela Hee SSS ese See sees Ses esee | 
116¢€1C) | 
| Value 4 | 
| | 

SVC 2,parblk 

partlk DC a? 

BC H*jcturnal cede’ 

DC F*value 1° 

DC F*value 2° 

DC F* value 3° 

DC Ff value 4° 


Figure 3-1 SVC 2 Ccde 0 Parameter Block Format and Ceding 


During execution, a lojgical O2 cperéticn is performed on the mask 
and the jovrnal code tc ensure that the entry crigqinates frem an 
SV¥C 2 cede &, and net from within the system. The values 1, 2Z, 
3, and 4 fields of the parameter block are stcred following the 
journal ccde and calling task name in the journal. These valves 
can cortair any desired infcrmaticn to he preserved fer system 
dehugging.e 


3-3-2 SVC Zz Code 16 (Fermat 2) 


SVC 2 ccde 16 (format 2) ciiranges a user-specified file descrirfter 
(fa) in an ertask or privileged u-task from an unpacked format tc 
a packed formate This creraticn is accemplished through the SVC 
2 code 16 parameter blcck.e. If format 2 is executed in a uetask, 
the pack id operaticn cccurs, hut the result cannot be used in a 
subsequent SVC 7 operaticn. 


Format Z of SVC 2 cede 16 can be used only by a rrivileged 
u-taske The uwu-task Eecomes rrivileged if the acccunt privilege 
option was specified in the OPTION ccommand at link time. The 
account privileqe option gives u-tasks the privilege to access 
files by specifying an account number instead of a file class. 
However, it the task lcader has the e-task load opticn rrevented, 
the privileged u-task is lcaded into memory with the acccunt 
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privilege orticn changed to the defeult ne acccunt rrivilege. 
Therefore, accéss py account number cannot te performed. 


The pack fd operaticn ir fcecrmat 2? ig the same as in format 1 


except for the fcllcwine: 


o The fd in format 2 ditfers from that of format 1 in the file 
class portion. The fd fer fermat 2 is: 


vOoln:filename.eext/actno 
cev 


The actne iz a decimal number frem C threush 255 rerresentirg 
the user acccunt numter. 


Oo Tha £VC 2 code 1€ parameter ticck option field is the Same as 


that for fermat 4s The hexadecimal valves for the cpticn 
tieid difter trom these in fermat 1, but their meanings are 
the Same. Since the meanings fer these ovtions are the sare 


as trose in feormat 1, refer to the mcre detailed descrirpticn 
under the format 1 crticns.e The ortions for format 2? are: 


CPTICN MEANING 

xX*'u3s Default vclume is system vclume 

x°438° Lefault volume is system volume; skip leading 
blanks 

x*'28° Default vclume is spool velume 

x°68* Default volume is srocl volume; skip leading 
blanks 

> tale =o ti No default volume 

a'Cs* No defaylt volumes skirc leadina blanks 


The area recéiving the racked f4 is the same as format 1, with 
the excerticn cf the file class field. The fcrmat of the 
racked £d area used in format 2 is shown in Figure 3-2. 


oO 


nae e ewe O22 Be ast eeaewwe SBewe Bese Se we wees 2 @2e 2 2 we @e wees @2 @ & Oe @ ew Se = 


joco) | 
j Volume name cr device name | 
| 
ieee a 
14(4) | 
: : 
| 

 Reeteetaeteeieteninieeietentetaetees Filename = s#ese--- woe eee | 
)8(8) l 
| | 
| l 
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| Extensicn | Account 


-* | 
}12¢(C) {15(F) | 
{ 
| | number i 


Figure 3-2 Facked File Descrirter (fd) Area for Format 2 


The t<byte account number field receives the packed forrat cf the 
user-specitied account number. The account number in the 
unpacked fd is specified as a decimal number ranging from 0 
through 255. 


Atter executing the pack fd operaticn, the user-specified acccurt 
Number is represented as a hexadecimal value ranging frem *X*OC* 
tnrouyr ¥"kF*, and the condition code is set to 2 (% bit set). 
lt no account number is specified in the unpacked fd, an S$ is 
returned in the accecunt numbrer field cf the packed fd when 
Cuaning under the operating system; a P is returned in the 
account number field of the packed fd when running under 
multi-terminal sonitor (MTN). If one of the three file classes 
in format 1 dis specified as the account number in the unracked 
fd, that file class is returned in the account number field cf 
the packed fd, and the € Frit is not set. 


The conditicn ccde settings for format 2 are the same as fcr 


format 1, with the adéditicn of the € Pit setting. The conditicn 
codes are: 


IC{VIc|1] 

fO,oPoOpe] Normal executicn 

japses—e | 

Oyo ,oO No veclumé nane rresent ir unpacked fd. 


JOP C]AIC] A numeric account number present in account 


ese Se= | numker tield. 
JOT tmotc] Syntax error present in unpacked fd. 
;TPO [OC No extension fresent in unpacked fd. 


3.3.3 £VC 2Z Code 26:3 Fetch Device Name 


SVC 2 ccde 26 searches for a user-supplied volume name in the 
volume mnenonic table and returns the device name on which that 
volume is mcuntéede Tne Ooperaticn is accomrlished through the SVC 
2 code 26 garameter blcck shown in Figure 3-3. 
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joci) }101) }2(2) User 13(3) User | 
| né€Sserved | Code J register 1 | register z | 


SVC 2,parblk 


parctlk ALIGN 4 


vi 6,26 
DP user register number 
LE user reyvister number 


Figure 3-3 SVC Z Code 26 Parameter Plock Format and Coding 


This parametér bicck is four kEytes long, fullword boundary 
aligned, and does net have to be in a writatle segment of the 
taske The fields are described as follcws: 


Fields: 

Reserved is 4 lt-bkyte field that must contain a value cf 
GC tc indicate no options for the call. 

Code is a j-byte field that must contain the 
decimal value of 24 to indicate code 2f of an 
SVC Ze 

UseL is at-rtyte Field that must contain a user- 

recister 1 specified register number. The specified 
register cecntairs a vcinter te a fullwcrd 
containing a UY-character volume name. 

USer is ai-tyte field that must contain a user- 

register 2 specified register number. The specified 
register ccontains the address of the aré€a 
receiving the device name. This area is 4 


bytes long, fullword boundary aligned, and 
must ke located in a task writahle segment. 
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Possible conditicn codes cccurring after SVC 2 cede 26 executicn 
are: 


eee ke 
{JOJO {o]c| Normal terminaticn 
{O} 1O{C] Specified vclume offline; no fetch occurred. 
Example: 
LA R1,“IMVCIN 
Ls R2,“IMCDRVN 
SVC ZeFTCHDEVN 
ALIGN 4 
FICKDEVN Cb C,26 
Ls 51 
CE R2 
3.4 SVC 7 


All SVC 7 £Eunctions used by u-tasks are available tec e-tasks and 
privileced u-tasks. SVC 7 rrevides the following additicnal 
cavabilities to e-taske and privileced uctasks. 


3.4.1 Assign, Fepretect, and Pename Functicns 


An e-task and a privilesed u-tesk can bypass the file manager and 
directly assign I/G requests toa a disk device. When an e-task cr 
privilesed wtw-task issues an SVC 11/0 request directly tc a disk 
device, the operation is referred to as hare disk I/9 and shculd 
always ke random access. The supperted I/O functions e@re read, 
write, test, and set. 


Direct assignment te a disk device can Fe frerfermed only by a 
privileced u-task. A ue-task becomes orivileged if the disk 
privilege orticn was specified in the OPTION command at link 
time. The disk privileg3é oction gives u-taske the privilege te 
bypass the file manager ana directly assign to a disk device. 
However, if the task lcader has the e-task orticn rfrevented, the 
privileged u-task is lcaded inte memory with the disk frivilese 
option changed tc the cdeéefault ne disk privilece. Therefore, bare 
disk I/C cannot te pericrmed by the task. 
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There are two tyres of direct disk assignments: online ard 
offline. If the disk is marked online, only assignments fcr 
shared read only (SkC) are allowed. Any other access) privilege 
specified at assignmert time is rejected, and this ressage is 
displayed: 


PRIV-ERE 


If the disk is marked cffline, all access rrivileges are allcwed. 


An e~task can regrotect Eoth devices and files. The rrotecticn 
of a device or file can ke changed te or frem X‘FF* 
Cunconditional frotecticn). An e-task does not have tc srecify 
keys when assigning a pretected cevice or file. When an e-task 
issues an SVC 7 rename function, the e-task can change the name 
of a device. 


3e4.2 Extended Close Function 


The extended clcse function X*FF&O* closes the specified Ilcgical 
unit (iu) and replaces the date and time of allocaticn and the 
last write (or write filemark) cpersetion in the disk directcry 
with the information from the parameter block. The format is 
shown ir Figure 3-4, 


{}c(uv) }2¢€2) {3¢3) | 
| Function code | Error status | ly | 
| | | 
a a a le ec | 
14(4) | 
| Allocation dete/tine i 
(roved into DIRMATE) | 
poeeseenetaeearee ele iar ke cia ee ae ge ers | 
6(38) 


| | 
| Last write operaticn date/time | 
| (ncved into PIR.LUSE) { 


Figure 3-4 SVC 7 Parameter Bicck for Extended Close Functicns 


Tf a uetask executes an extended close functicn, the Error ccde 
X°01° is returned to the parameter tlock errer status field. The 
format cf the date/time field in the parameter tlock must he the 
Same fcrmat cgenerated by the routine TATF.DIR. This subroutine 
is located in the file manager utility (CFMUT) mecdule. These 
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functicrs can te executed threugh an SVC 7. No correspcnding 
operator command exists for this call. 


3.4.3 Extended Fetch Attrikutes Functicn 


The extended fetch attributes function fetches the attributes cf 
a bare disk device thrcugh its assigned lu. The write attribute 
is reset in the attributes halfword field (SVC7.KFYS) of tke 
parameter tlock if the disk is marked on pretected. The 
following device dependent information is returned to the 
parameter block: 


fe) The thysical address cf the ccntroller is returned tc the 
index bleck size (SVC7.1SZ) field. 


oO The ghysical address cf the channel is returned to the data 
block size (SVC7.DSZ) field. 


3-5 SVC 6 RELEASE 


For system tasks (.CMDE, CSL, .MTM, and .SEL) the SVC 6 release 
function allows tne user to specify the address of the 
instructicn the task shculd execute after it is released. This 
address is stored in the £VCO.SALP field. If this field contains 
O, the task continues executing with the instruction following 
the instruction executed refore the task was suspended. 
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CHAEFTER 4 
SUPERVISCR CALL (SVC) INTERCEPTICN 


4.1 INTRODUCTICN 


SVC intercertion software is used to write programs that can 
emulate the SVC processing ability of 9OS/32. This software 
consists of macrcs that allow a task (intercepting task) te 
intercert the SVC of ancther task before it gces to the operating 
system for prec#ssing. Once interrupted, the SVC can te 
monitored by the intercepting task and sent to the cperating 
system for precessing, or it can te placed under the control cf 
the intercerting task fer processing. Tahle 4-1 lists the system 
Macros used for SVC intercerticn. 


TABLE 4-1 SYSTEM MACRCS FOR SUPERVISOR CALL (SVC) INTERCEFTICN 


macros anc branches execution to specific error 
reutines within the intercepting task 


KACKC | FUNCTION | 
=sS=S SS SS Sa SS SSS TS SSS SVS SSS SST BTS SVS SSS ST SSS TS SS SST SS SS STS SLT SS SST SSS TST SSS = | 
TOREREE {| Creates an SVC intercert path | 
| [ 

IREMOVE {| xemoves a previously created path | 
| 

IGET | Gets data from a data area of the applicaticn task | 
| that issued an intercepted SVC | 

| 

IPUT | Puts data intc a data area cf the applicaticn task | 
| that issued an intercepted SVC | 

| | 

ICCNT j Continues standard executicn cf an intercerted SVC | 
|} by passing centre] te an CS/322 SVC executer | 

| | 

IPROCEED | Allows the application task that issued the inter- | 
| cepted SVC tc preceed with its execution | 

| | 

IROLL | Makes an intercepted task rollable | 
| | 

ITERM { Terminates an intercepted SVC after precessina | 
| | 

ITRAP | Sends a task queue item to a task | 
| | 

IERRTSTI j Evaluates errers returned by any cf the abcve ] 
| 

i l 
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The intercepting tasx tells the 2S/32 SVC evecutor which SVC it 
Will control cr monitor. Y#hen the intercepting task is sent an 
SVC f£rem the executcr, the interceptinad task executes the SVC 
while the arpilication task thst issued the SVC is placed in a 
Wait state. The intercepting task can read frem or write tc the 
address space cr the agrerlicaticn task while executing the 
intercerted SVC. 


The aprlication task is not aware that its SVC has been 
intercerpted unless it is informed Ly the intercepting task. 


A task can intercept SVC calls only after it is linked with the 
intercert cpticn.e. Once linked tec the SVC interception software, 
the task can be programmed to intercept any of the follcwing SVCs 
issued ty any arpplicaticn task in the system: 

o SYC 1 


o SVC 2 ccde 7 


o SVC 3 


4.2 HOh SVC INTERCEPTICN WORKS 
In general, SVC intercerticn software functions as fcllcws: 


1. A task with SVC intercerticn enabled by Link is huilt. This 
intercérting task must: 


- reserve memory ter 4&4 set of request desecriptcr bkleck (FLE) 
tutters fcr eacn SVC to fre intercepted, 


~ tuild a circular list for stcring addresses cf PIP buffers 
containing informaticn of intercepted SVCs, 


- create intercept paths that designate which SVCs are tc te 
intercepted (via ICEEATE macre), and 


- define what control the intercepting task has over the 
SVCs it intercerts (via ICRFITE macrc). 
2e An aprlicaticn task issues an SVC. 


3. If no intercept path was created fer that particular SVC, one 
of the standard OS/2z executors services the SVC. 


KH, If an intercept path has been created: 
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~ the SVC is intercepted, 


~ intormaticn identifying the £VC is cktained and stored in 
@ bvutfer whose address is removed from the circular list 
containing the address of free PER Euffers, and 


- the intercepting task is notified that an SVC is ready fcr 
ErccesSing by a task event trap. When the task event trar 
service routine starts executing, register 1 contains the 
address cf the REE associated with the intercepted SVC, 
and register 0 centains the intercert rath identifier that 
was supplied by the system when the intercept path was 
created. (Tc exit from the task event trap service state, 
the intercepting task issues a TEYIT macre.) 


ten If the intercepting task intercert rath had been Evilt to 
moniter this SVC, the SVC is returned te the operstinag system 
for ncrmal executicre 


6 If the interceptiny task nas chosen to service the SVC, it is 
now ready te do so ty issuing the intercept macres IGET, 
IPUI, IRCLI, and ITKAP. Rise, the intercertine task can 
issue the IFROCEED macre to allecw the arplication task to 
continue executing during SVC processing. 


7. After the intercerting task rrecesses the SVC, the 
intercerting task iaisezves an ITEPM macre that transfers 
control pack to tne app-lication task. 


4.3 PREPARING IC CREATE AN INTERCEFT PATH 


Before creating an intercert path, an intercepting task must: 


e) have a sé€t ct KkKD3 kEutffers fer each type of SVC tc te 
interce, ted, and 


re) build a circular list tc store the addresses of the EIB 
buffers. 


The saze of each RDE buffer depends on the size of the rfarameter 
block tcr the particular SYC tyree For example, a set cf huffers 
allccated for SVC 6 intercerticn will he larger than a set cf 
buffers fcor SVC 1 interception. When an intercepting task uses 
one set ort rEufters for intercepting two or more SVC types, tuffer 
size must equal the size of the 3P8 needed te hold the largest 
Parameter block cf the particular SVC tyres. Fiaqure 4-1 shcws 
the RODE £fieids. To define a structure containing these fields, 
use the SRKDE macro. 
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{2(02) Intercepticn 


| 
{ neserved { identifier | 
| C(RCE.RITL) | (RDE. FID) | 
Ipeiaishay aint eeones aes ncemacn sacs sie laiptpislntetetabanetaiatatateneisiaiptaieiecenaatanaaenanana | 
}4(004) Tarameter Elock cffset {46(0°6) SVC 17€07) Task ] 
| (KEDOR.OFF) | tyre t rriority | 
| { CRDESVC) {| (CPDE.TPRI) | 
feeee Seen eda scence seasons ste neo senso nas arase se aeee=ncacas 
}8(08) | 
| Operating system task identifier | 
| ' (REEZPAT) | 
eietedoecteteratetetaretatatatatatatatatanetatenatetatetatetertarananatenedatansneninatanatennnaatanaenien | 
{12(0C) | 
| SVC parameter blcck address | 
| (RDE.TIC) | 
[Ries sete ere raso ty sherake aoe menee ans epee near dieseatew ness | 
}16¢1C) Instruction address followine j 
| intercepted £VC instruction | 
(KDP.S VAD) 
ec al io | 
{20(14) | | 
| SVC parameter blicck 1 } 
| CRIB.TF) { 


The fields 


Fields: 


Reserved 


Intercerticn 
idertifier 
(ROE. 


Parameter 
block 
offset 
(RDE.CFE) 


nn (nn) SVC rarameter klicck n 


Figure 4-1 KFequest Lescriptcr Bleck (RDP) 


contained witnin the RD? are descrihed as follows: 


is a halfword field reserved for future use. 


is a halfword field containing an SVC inter- 
ception bath identifier exclusively reserved 
for cne particular SVC interception. 


is a halfword field containina the hexadecimal 


hexadecimal offset value for the rfrarameter 
block witnin the RER. 
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the ficlds cf 
the interceygting task fer processing, 
automatically 
tilled with intcrmation identifying the intercerted 
Medel 3220 
and 
Publicaticn 


Number C29-€93 
Manual, 
explanation of the 
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SVC 
tyre 
CREPSEVC) 


Task 
pricrity 
CRDE-TPFI) 


Operating 
system tasn 
idertifier 
(RCDE.TIL) 


SVC parameter 
blicck address 
CRUE.FAL) 


Instruction 
address 
following 
intercerted 
S¥ec 
instruction 
CRDE.SVAD) 


OVC parameter 
bicck 1 
CRDEPH) 


The intercepting task muSt have a4 
the address 
the standard circular list. 


tc held 


Perkin-Elmer 


9/E 1 


remnoved 


is a 1i-btyte field containinn a decimal number 
specifying the type of SVC that is te Le 
inte recerted. 

~ G1 indicates SVC 1 

- O02 aindicates SVC 2 (rarareter bicck 


ccntains a decimal value of 7, indicatirg 


ar SVC 2 cede 7) 


~- O02 indicates SVC 3 
- O€ indicates SVC 6 
~ QO7 indicates SVC 7 


1s 4a I-cyte field containing a decimal numter 
specifying the pricrity of the arrlicaticn 
task that issued the intercerted SVC. 


is a 4-ebyte field containing the orerating 
system task i¢entifier fer the arrlicaticn 
task that issued the intercerted SVC. 


is a %-tyte field containing a hexadecimal 
number specifying the address of the SVC 
parameter beins intercepted. For SVC 3 inter- 
ceptions, this field contains the end of task 
code. 

is 2a i-rEyte field containing a hexadecimal 
number specifying the address of the instruc- 


tion fcllowing the intercerted £VC instructicn 
in the arplicaticn task. This field is set to 
for SVC 3 intercerticns.e 


is a vzriatle lenath field containing the 
Farameter hleck cf the irtercepted SVC. 
standard Ferkin-Flmer circular 


of each PDF buffer. Figure 4-2 shcus 
When an SVC is sent te 
one PYPR huffer address is 
list, and the RDP is 
evc. Refer 
Precessor User's Manual, Puklicaticn 

Medel 3240 Processcr User's 
C25-6F°5, for a mere detailed 
list. 


from the circular 


Parkin-Elmer 
Number 
Etandard circular 


Fi 


ye 


ssa en ee ee ee eT Fe Beware we FZ were ewes as ZF eweewrs Fee Boa weneewa Dee enw ePF @2 eee Be 


{c(oo) {2¢C2) 

| oumber | Current number 

| oi ktutfers | ef buffers 

| a se eS seams sims “Ss. as i ce ms sein a ws ene ask sca Sam ce ee es ‘Ss es vee ene nd na ee Se oe, 
P4054) {6(C6&) 

| Current to; { Next bottom 

| | 

| ae ewe OB ew Oe Re Oe SO OO ee OO OE SS SBE TZeaeeaeawes eawn cease ae ae ae - 
{8(98) 

| » (buffer 1) 

| 

{ a ec Sosa <a" sw ma “es si "ei Sa isa“ sa, seca ces” cen mses seis ls! Meio" Suus “ps "cas<es“teesc tu ca lhtce ei aes ec oe (te a 
}172¢€0C) 


| 


— 


ww ee Oe Be Oe ee S&B eeanwswewe @e eae 2B eas ewe See ee 8 ee Se B22 Gea ew aeeraewaee aoe @ 


Figure 4-2 


elds: 
Numrer cf 
butters 


Current 
numter c£ 
bufters 


Current top 


Next botton 


A (Ckuffer n 


on 


) 


System Task Buffer List (Standard Circular List) 


a halfwerd fielc indicatine the 


the entire list. 


is 
fualwcrds in 


is a halfword field indicating the number 
fullwerds currently in usee When this 
eguéls u, the list is empty. 
equals the number of fullwords 
the list is full. 


in the 


is @ halfword field indicating the address 
the FOR Eutrfer that is currently at the top 
the list. 


is @¢ halfword field indicating the address 
the next ‘LF Fuffer that is at the Eottom 
the list. 


indicates the address cf the RD2 buffer. 
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cf 
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G4 CKEATING INTERCEPT FATHS CICREATE) 


sefore an intercepting task can execute an SVC, it must create a 
path tc the aprlicaticr tack that is te have an SVC intercepted. 
It does this thrcough the ICREATE macre that inferms the E£VC 
executcr which SVC is to be intercepted ty this path. The 
intercepting task also accesses the application task address 
space through the intercept path. 


An intercert path remains in effect until it is removed by the 
intercepting task creating it or until the aprlication task 
terminatese Although only cne tyre cf SVC can te intercepted fry 
each path, there is ne limit to the numher cf paths that can te 
created by cne intercertinj task. 


The mode parameter cf the ICREATE macro specifies when an SVC is 
to be intercerted. Under caller ermcde, the specified SVC is 
intercepted every time it is issued from an application task. 
When the recipient existent mcde is specified, the SVC is 
intercepted only when it is directed tcewards a specified task, 
device, fséudo task, cr pseude device that already exists in the 
system. Under the recirient nonexistent mcde, the SVC is 
intercepted only when it is directed toward a specified rseude 
task or pseudo device created by the ICREATF mecro. 


4.25 HOW TO CREATE A PSEUDO DEVICE CR TASK WITH ICREATE 


A pseude device consists cf a name and the SVC 1 er SVC 7 
intercert patns attached tc ite. The rnseudo device name, which is 
Known to the system Lut does net actually refer to any system 
device or filé, consists of a device name, filename, and 
extensiche bee a device name that does nct already exist for a 
real device or Gdisk volume. FPseude devices indnecre the account 
humcter field. 


When the orerating system searches for a device or filename and 
cannot find it in the svstem, it will search the list cf rseudo 
Gevices. If a match occurs, the system will continue erecessirg 
the SVC usirg the pseudc device. 


To create a pseudo device using SVC intercepticn software, set 
the ICKEAT: macro fcr either an SVC 1 or SVC 7 and srecify the 
reciplent ncnexistent mcde. An SVC 1 intercert path must te in 
effect it an I/09 ogeération is attemrted tc a pseude device; 
otherwise, an invalid frenction (¥'CC") error status is returned. 


AR nseudc task ccnsists cf a name attached tc one or mere SVC 6 
antercejt paths. A ecseude task name is known to the system but 
dees net refer te an actual task already existing in the system. 


To create a pseudo task, issue the JCRFITE macre srecifying SVC 
6 and the recipient nonexistent mode. Fecause a pseudo task does 
not refer ts areal task, the rseudo task cannot be cancelled. 
Both pseudo tasks and gseude devices are deleted by reneving all 
intercert paths attached tc ther. 


4.6 USE OF GENERIC NAMING FOR FSEULO DEVICES ARD TASKS 


A pseudc device or task can be gqanerically named. The following 
characters can te used for generic naming: 


© An a&sterisx (*) represents any character cr tlank. 


o A backward slash (\) represents any character. 


If a pseudo device or task name specifies the filename and 
extensicns fields as blanks, the system sukstitutes filename and 
extensicn fields filled with ésterisks. This has the effect cf 
generically naming the filename and extensicn fields so that they 
will always match the irgut filename and extension. 


veneric naming cannet ke used te name pseudo devices or tasks 
using the ICREATE macro. Tf recirient existent mode is esnacified 
with a generic pseudc device cr task name, a pseude device cr 
taSk must exist with its name exactly matching the cne specified 
by ICKEATE, or an €rror will result. For example, a syster is 
asked tc create the following rfseudc devices: 

o FAKE sEILE1 

re) FAKE SEIL#E* 

re) FAKE: 

re) FAKE sEITLe* EXT. 


Normally, the followirg input will match the abkcve rseudo 
devices: 


ING UT wAXNéE StIECTEC PSEULC LTEREVICE 
FAKE: FAKES: 

FAKESFIILE3 FAKE: FILE* 

FAK rskEIL#1 FRKEs FILF14 

FAKEsFiI=11 FUKEs 

FAKES FIIEX.EXT FAKES FILE*.PYT 
FAKrsFILEX. EX FAKEs 


When the iCEFLATE macro is issued svecifyina recipient ncnexistert 
mode and the pseudo device FAKFs:, ICREATE will not ka executed 
beacause tne aseudo device already existse Consequently, when an 
ICREATE macro is issued srpecifyingo recirient existent mcde alcng 
with the rgseude device FAKE:FILE*, ICEKEATF will he executed 
because the pseudo device FAKE: FIIE* already exists. 


Y= - BE-CHO FOOD Q9/E1 


4.7 FUNCTICNAL SURMARY CF SVC INTERCEPTION 


The following describes hew intercertion works for each SVC and 
modes 


o SVC 1 caller - Any SVC 1 issued ty the srecified task is 
intercepted. 


o SVC 1 recipient existent - Any SVC 1 directed to an lu 
assigned tc the specified device cr eseude device is 
intercepted. (Nete that disk volume interception is net 
supperted for SVC 1.) 


re) SVC 1 recipient nonexistent - The pseudo device is created, 
and any SVC 1 calls srecifying an lu assiaqned to this pseudo 
device are intercepted. 


re) SVC 2Z code 7 caller - Any SVC 2 code 7 issued by the specified 
task ais intercepted. 


o SVC zZ code 7 recipient existent and nonexistent - These calls 
are invalid. 

fe) SVC 2 caller - If the srecified task aoes to end of task fer 
any reascn, an SVC 3 intercert will occur. 

o SVC = recipient existent and recipient nonexistent - These 
calis aré invalid. 

fe) SVC € caller - Any SVC & issued by the srecified task is 
intercepted. 


o SVC € recipient existent - Any SVC 6 directed to the specified 
task or rseudo task is intercepted. 


o SVC € recipient nonexistent - The pseudo task is created, and 
any SVC € calls directed to this rseude task are intercerted. 


o SVC 7 caller - Any SVC 7 issued by the srecified task is 
intercepted. 

o SVC 7 recirient existent - Fny £VC 1 directed to the specified 
device, disk volume, or pseudo device if intercepted. 


o SVC 7 recipient nonexistent - The pseudc device is created, 
and any SVC 7 calls sgfecifyina this rseudce device are 
intercepted. 


4.8 FUIL AND SCNITOR CCNTRCL INTERCEPT PATHS 
The ICREATE macro specities the level cf control that the 


intercert rath allows an intercepting task to have over an 
application task. 
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A full control intercept path allows the intercepting task to 
exert full control cver an arpnplicaticn task whose SVC has teen 
latercepted. Specitically, the intercepting task can: 


Oo make the application task rollable via the I80IL macro. When 
an SVC is intercepted, the aprlicaticn task issuine the SVC is 
rlaced ina wait state and made unrollable. At the discreticn 
of the intercepting task, the application task can be made 
rollable (assuming that the application task is able -to te 
rolled). . 


o allow the application task te execute while it precesses 4a 
proceed SVC via the IPSOCEFD macrec. When an SVC is 
intercepted, the application task is placed in a wait state 
and made unrollable. At the discreticn of the interceptirg 
task, the upgrlication task can proceed with its executicn 
while the interceptirg task rrecesses the SVC. 


o cbtein data from the aprlicaticr task memory srace via the 
IGET macroe 


re) write data into the writable memcry space of the arrlicaticn 
task via the IFUTI macrc. 


o send a task gueve item to the aprlication task via the ITRAP 
MacrlCe While eprecessing the SVC, the intercerting task may 
find it hecessary tc send a tack queve item to the arplicaticn 
task. The task queve item sent must have a valid OS/32 reascn 
code in the high order Lyte. Tr addition, the arrlicaticn 
task Sh must not have the task queve entry rit associated 
with the reascn code disabled. 


A moniter ccntrcl intercept nath intercepts an SVC to inform the 
intercerting task that the application task has issued that call. 
Once the dintercepting task is aware that the SVC is ready fer 
executicn, the SVC is sent to tre crerating system fer nermal 
processing. 


The following guidelines shculd te followed when assigning a 
level of control to tae intercert rath: 


o Cnly monitor control can be specified for SVC 3 intercert 
pathse Either full cr monitor control can he specified fer 
all cther SVC type irtercept paths. 


re) Cnly one full contrcl intercept rath can be attacked te a 
device or task (or rseudo device or task) for each tyre of SVC 
to be interceéerted. 


re) A task cr device (or pseudo task cr device) can te attached to 
any number of monitor ccntrol intercept raths. 


u=40 _ W8-049 ROO 9/81 


Exagple: 


ICKEATE NAME=MAG:, MCTE=R¥,CCNTPOLEFC, 


svVC=(7) 

ICKREATE NAME=MAG3, ¥CDE=FX,CCNTROI=FC, 
SVC=(1) 

ICREATE NAME=HAG:, MODE=EX,COCNTROL=NC, 
SVC=(7) 

ICREATE NAME=MNAG:, MCCDE=RX,CCNTROL=NC, 
svC=(1) 


In this example, a full control SVC 7 intercept path is attached 
to device MAG:. A full contre] SVC 1 intercept path is also 
attached to MAG:. No cther SVC 1 cr £VYC 7 Full control intercept 
paths can be attached. Of course, any number cf SVC 1 and SVC 7 
monitor control intercert faths can ke attached to MAG:; here cne 
SVC 7 ard one SVC 1 moniter contre] paths are attached. 


4.9 HOh INTERCEFT FATHS HANDLE SVCS OCCURRING AT END OF TASK 


SVC 1 and SVC 7 can be intercerted during end of task rrocessing 
(including end of task frocessing after cancel), if intercert 
paths exist from these $VCs to devices assigned te the task‘s 
logical units. The iaintercetting task must be careful when 
writing intc the operating system address epace when erecuting 
these SYCs s0 as not te destrey the system's integrity. 


If the apgrlication task is cancelled while the intercentina task 


is processiny the SVC, S¥C precessing is aborted and the 
application task proceeds te the end of task. 


4.10 TERMINATING THE INTERCEPTED SVCS 


When the intercepting task receives an SVS frem ae full centrcl 
intercert path, the intercepting task has the ortion of returnirg 
the SVC to the operating system for precessing. To do this, the 
intercerting task issues an ICCNT macro that allows the creratinrg 
system to resume frocessing the intercepted SVC as if the 
intercept had never occurred. The ICONT macro cannot te used if 
an IPROCEED or IFCLI macro has tTeer issued to the arrlicaticn 
task. 


If the aintercepting task chcoses te fpfrocess the SVC, the 
intercerting task aisstes an ITKEM macre after the SVC is 
processed. ITEFN terminates the intercepticn and, if ne IPROCEED 
has been issued, allows the application task to resume executicn 
with the instruction immediately folloving the intercepted SVC 
instruction. 


Either ICONT or ITcKMN can be used tec terminate intercenvtion alcng 


a monitor control antercept path. The eystem does net 
differentiate between the two calls in this case. Fere the ICCNT 
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or ITrFM macre repleces the RPS buffer address kack cn to the 
Circular list. It is very important that the ICCNT or ITEEM 
macro be used tc replace the RUE. 


Cancelling an arelicaticn task under monitor ocr full centrcel 
aborts the precessings of the intercerted SVC in progress. The 
intercepting task must still issue an ICCNT or ITERMF to terminate 
the SVC interception. 


4.11 HCW TC REMOVE INTERCEPT PATHS 


An intercepting task car remove an intercept rath by issuing an 
IREMOVE macrs specifying the rath te be removed. IRE“CVE can Le 
used for both immediate and delayed termination denending cn 
whether the controlled shutdown or abert crticn is chosen. 


The controlled shutdown cotion refuses all incoming reqvests 9 and 
completes the servicing cf all existing queved and executing 
SVCs. bwhen processing cf the last existina SVC intercepted ty 
the path is comrgleted, the bath is removed from the system. 


The abort ortion terminates all existing aueued and executing 
SY¥Cs before remcving the intercept path from the system. 


4.12 EFROR HAN-TLING 


Run time errors that result from executing intercept macros are 
handled by user-written error revutines within the intercepting 
taske when an error occurs, executicn branches tec the reutine 
specified ty either the IJIEFFIST macro cr the error rarameter 
associated with each macre. 


Tne IFRFIST macro is written immediately after a macre for which 
the error parameter kas been cmitted. If an errcr occurs, 
executicn of the intercepting task will branch to a user-written 
error xreutine to handle the errere Frror codes returned by the 
IER RIST macro ure listed in Tatle 4U4-?, If no eé€rror cccurs, 
executicn continues at the instruction following the IERRIST 
MacrlOe 


If the ERROR parameter is specified with an intercert mracre ard 
an @rrcr cccurs, e€xecuticn tranches to the srecified errcr 
routine within the intercepting task. If no error occurs, 
executicn proceeds to the next executable source statement. The 
error rcutine pcinted te by the FRECR parameter can ccentain = an 
IEREIST macro tc identify what errer has cccurred. 
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TABLE 4-2 ERROR CODES RETURNED FCR INTERCEPT MACFOS 


ae wenwmwne Gea nweaeswoeoew ees De ee @eeeewar we Bee ee eee weaese BS etm een wees @eonwe Ge ewm > 


| Z£FRCR | | BELEVANT 
{ CBE. «| MEANTXG } WFECECS 
j== a a a Sd 
}] MC | Invalid interception mode | ICREATE 

| ewe ae cen en ee mama ema anawen eee “cms ee ‘nn Goss ti ms | aida“ cca“ ee 
} AL | Invalid address in parameter con- | ICREATE 

{ | txrel Elock (PCB) } ITERY 

| | | ICCNT 

| | | TREMCVE 

| | {| ITRAP 

| | | IGET 

| | } IPUT 
pieces cs ea sas eee ce RR eee 
| 2% | Task cr device exists when it } ICPEATE 

| | should net, cr dees net exist when | 

| } it snculid ! 

| meen own a an anaame eee wean en aan ec ewe aw wae eww ae wm ae eon oo e as 
| SE | Insufficient system Srace to do {| ICREATE 

| |} ceguest, cr NINTCS64 cr PESIZF>998 | ITER¥F 

| | | ITRAF 

| | | IGET 

| | IPUT 

| ee Scene ew ee eae oe we we wee =weweee noes 
| CT | Full contrcl already selected } ICREATE 

| | | IROLI 

| | | IPROCEED 
| i | ITRAF 

| | | IGET 

| | IPUT 

| on en nn wo ne on en nn ee ee ee + ee 
} HE } Invalid queue handler name { ICPSATE 

| a eo nn nnn nn ~ 2 ee ee oo 
bt J Invalid device name or task name {| ICRFATE 

| a ee ee ee 
{34 j anvalid state for call; e.9., J} IREMCVE 

| } LECLL followed by ICCNT cr issuina { IROLI 

| | TEUT with monitor control inter- | IFROCEED 
| J cert path | ITRAF 

| | | IGET 

| | } I?uT 

| aKa EE OES DOSED EO eRe Baerenwa wren ese eee e wees ween wa ae = 
| Ter | Task queue item net added { ITRAF 

| ower ee we ee ee wm ene wen Dew Be OOO ee Ew ewe Bw ee ww ee! eee oe ee 
{ A. | Invalid RIB } ITER*é 

| | | ICONT 

| | {| IRCLI 

| | | IPROCEED 
| | | ITRAE 

| | | IGET 

i i | IPUT 

| eee ee ewe em ee ew ew ean eww nae wean es BeBe COBO wR ee Dee w ew ew Cee 
| It | intercept path cerresrending to | IREMCVE 
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ee eS ee _ __  _ ee eS |” | Oe lL 


| | this gath ID does not exist | | 


| «Ff | Attempt tc cepy SVC rarameter | ITER® | 
| | bicck back into write protected | 

i } area | | 
| ~ = -- =~ -- == 222 2-2 noo oo 2 2 en ee nn enn 
{ clr {| Invalid stktccde in SVC rfarameter { ALL | 
| | blcck | | 
| We BEE BSS BEDS BEE BOOananene ese ee eee ae eae e Cen e cone saaa eo 

|} NI | Intercepted task has qoene to end } IROLL | 
{ | of task {| IPROCEED |f 
{ i { ITRAF ] 
| | } IGET | 
{ | | IPUT I 


4.13 MACROS USED WITH SVC INTEFCEPTION 

Once configured for SVC interception, the operating system allcws 
tasks tc issue macros fcr SVC intercertion previded they were 
linked with the intercert cretion. 

This section gives the syntax fer the SVC macros descrited in the 
previous sections. Refer to the OS/322 System Macre Library 
Reference Manual for a list of syntax rules. 

§.13-1 ICREATE Macro 

The ICKEATE macro creates an intercept path for a particular SVC 


type. See Takle 4-3 for valid cembinaticons for the SVC, MCTE, 
and NAME: parameters. 


Formats: 


| 
KANE |  OPERATICN | CPEPAND 


ICREATE 


eMONF= PX 


RN 


a ne eee SE eee ou ST eee ae co ee ce 


eNAMF=pointer 
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etIL=pointer 
,CORTROL= 

KC 
*BUPEEPL=pointer 
eHANTLER=pointer 
ePID=pointer 
,EXYFC=peinter 
ePPST2Z2¥F=integer 
{[,oVik=rpeointer]) 
[,fERCP=pointer] 


[,2CP=pointer] 


[,NIXTC=n] 


ee cme sent SI eee gems Maree “SE cae eins ORR ete eee em “So eeeeey SOON Me Ee ee OE crm Ge Gun ite ene fen 
en mee etn Cen eee ctheme Sinem Si ROME Gree SEE setae etme Cotte SEES Utne Gmaen SOREN aerunen meee cme SEY Geet SE Gee Meee eee 


Parameters: 


SVC= is an integer, enclicsed ty rarentheses, that 
indicates the type of intercept rath te te 
created: 


- (1) indicates SVC 1 
~ (2,7) indicates SVC 2 cade 7 
- (2) indicates SVC 3 
- (€) indicates SVC ¢ 
- (7) indicates SVC 7 
MODE= indicates one of the fcllowing intercepticn 
modess 


- Cl indicates caller mcde 
- RX indicates recirient existent mede 


~ EN jndicates recirient nonexistent mode 
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NAW k= 


TABLE 4-3 


o_o ea ee ee ie ee ee 
ae a a ee Ge ee ae ee ee oe 


When CL is Srecified, en intercept path is 
created for all SVWCs (selected ty the SVC 
Faraneter) issued frem the task specified in 
the NAME or TIC rarareter. 


when Ka is specified, an intercept path is 
created for all SVCs (selected ty the SVC 
gkarameter) dirécted to an existing task, 
device, pseudo task, or rseudo device 
specified in the NAMF parameter. 


then RN. is srecified, a rseudo device is 
created for SVC 1 cr SVC 7, or a pseude task 
is created fer SVC €&. The eseudo device cr 
task is attached te the intercept path created 
ty the call. 


A pseudo task or pseudo device is deleted when 
all intercept raths attached to it are 
remcved. Yhen a pseudo device is agssiqned 
witncut SVC 7 interception, the requested 
access privileces are ianored and. shared 
read/shared write privileges are ararted. if 
an §€VC 1 4s attemrted tc a rsevdo device 
withcut an interception in effect, an invalid 
functicn errer (¥°'CC') is returned. 


indicates the address of the mercry locaticn 
specifying the name of a device, task, rseudo 
device, or tack. This lccation must te 
fullwerd beundary alianed and contain eight 
bytes cf bianks followed by a standard file 
descrigtcr (fd) or taskid. An fd must te 
cacked, left-justified, and padded with LElanks 
within the fullword. A 6taskid rust re 
left-j3ustified and padded with blanks. 


mhen EX or PF ais specified ky the MCIE 
karaneter, the standard fd or taskid given 
With the NAME parameter can include an 
aSterisk or a backward slash to allcw generic 
namirg. See Secticn 4.6. 


VAIID COMBINATIONS FOR SUPERVISOR CALL (SVC), MODE, 
AND NAME PARANETERS 


ee ee ee ee ee eee ee ee ce re ee eee es eee ee ee es eee oe ee ee ee ee ee ee ee 
ame ee ee ee ee eee a ee eee eee ee ee ee ee ee ee ee ee ee ee ee 


taskid | Intercepts any SVC 1 issued from the | 


} task | 
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| | xX |] td | Intercepts any SVC 1 directed to the | 
j j { | existina device | 
| {| RA { fa {| Creates a pseudo device and inter- | 
| | | | aaa any SVC 1 directed to it | 
le ieciwiahaiia use values wa aieiaraiaie aie sgsraiamac meine acca ages a a | 
i €2,7) | Ci { taskid | Dae eee ee any SVC 2 cede 7 issued | 
| | | { frem the tesk | 
{ | RX | ~< |} No function; srecifying fd or taskid | 
j | | | xvcesults in error | 
| { RN { -- { Results in error l 
ateetutaachetattaiatetaiatenetateieratetetatatetatesheetatarateratetatateiaateiinadtaiaateateniareneaniane | 
} (3) | cl |} taskid | ‘End cf task interception; occurs ne | 
| | { {| matter how a task terminates } 
| | EX | -- {| No function; svecifying fd or taskid | 
| { | } cvcesults in errer | 
| } KA | “= | Results in error i 
[Rae onaehe sete ass aaneere Soanereaseaae sae Sar ceas ane snes aa 
{ (6) j cl { taskid | Intercepts any SVC 6 issued frem the | 
| | {| task | 
| ee. {| taskid | Intercercts any SVC & directed to the | 
| | | | existing task | 
| | FA | taskid | Creates a pseudo task and intercepts | 
| } | { any SVC 6 ecirected to it | 
aa rig as gaurd al Sc ean sapere mc Slee Seas aseesee ! 
{ (7) { Cl { taskid | Intercerts any SVC 7 issued from the | 
| i |. | task | 
| } EX | id | Intercerts any SVC 7 directed to the | 
{ | | | existing device | 
| J EN |] fd } Creates a pseudo device and inter- | 
| | ] | coe any SVC 7 directed to it | 
TIC= indicates the address of a fullword locaticn 
containing a task identifier. This rarareter, 
which igs mutually exclusive with the NANE= 
garameter, can he used when MODFECI, cr 
MODE=RX with SVC €, to identify the task to re 
intercepted. The TIL can be obtained frem the 
KFDB.TIC field cf an FDF frem a rprevicusly 

antercepted SVC call. 
CONTRCL= contains a mnemcnic indicating either full 
contrel (FC) or mcenitcr control (C) over 
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intercepted SVCs. 


When 
exert 


CCONTRCI=FC, 
full control cver an aprlicaticn task’s 


an intercepting task can 


intercerted SVCs. 


When CO 
a menitcr 


TROL="C, 
cnly; 


an intercepting task acts 
it has 


as 
no centrcl ocver an 


inctercezrted SVC. 


HANILER= 


PIL= 


P3SIZEL= 


indicates the address cf the standard circular 
list that centains the addresses cf availatle 
RDB tuffers. 


The FLE used Ly the interceptinay task to 
identify an intercerted SVC must net be mcved 
to a new location after the intercention takes 
Blacee The system ensures that the address cf 
this RDE is the same as the address cf the RIB 
that was passed to the intercepting task when 
the interception occurred. 


indicates the address of a fullword locaticn 
containing the name of a queue handler. This 
name, a@ m@ximum of eight characters, is 
left-justiriéed and padded with blanks. If 
this parameter is omitted, the default queue 
handler is invcked. 


NOTE 


Currently, user defined queue 
handlers are nct supported. 


indicates the address cf a halfwerd lecaticn 
that is used by the system to store the path 
identifier fer the intercept path. 


as the addrees cf an SVC intercept executcr 
toutine within the intercepting task. This 
routine will precess intercerted SVCs of the 
type specified with the SVC yarameter. T[urirg 
SVC aintercerticr, the system removes an FIE 
specified by the list, fills at with 
infcrmation, anc queves a task event trarg with 
the specified executcr addrees tc the 
intercepting taske 


On ertry to an executor routine, F% contains 
the FID cf the intercept path, and R1 contains 
the address of the REB ktuffer associated with 
the intercepted SVC. The executor reutine 
executes as task event service recutine. 


is a decimal numter specifyinga the number cf 
bytes in the rarameter hlock for tke SYC 
indicated by the SVC parameter. 


when this parameter is oritted, the parameter 
tlock size defaults to the standard sizes 
docunented fer eech tyre of SVC in the OS/32 
Superviscr Call (£VYC) Feference Yanual, excert 
for SVC 2 ccde 7 intercepticn, which defaults 
to eight bytes. 
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SVAT= 


ERRCR= 


FOR K= 


Nii [C= 


The size of the RDR.FB field in the RDE fer 
this intercepticn rath is the value cf the 
FBSIZE parameter, cr its default if nct 
specified. 


is the adiress of a fullwerd locaticn 
containing user defined data. This data is 
Fasséed to the intercert Ilcgic. The quetve 


handler named ty the HANILER parameter can 
later access the data. The SVAPR parameter is 
for user defined epurpeses when needed by a 
user defined queve handler. 


NOTE 


Currently, user defined queue 
handlers are ncect supported. 


is the address cf an errer reutine within the 
intercerting task. If a run time errer cccurs 
for this macro, execution branches tc this 
errer reoutine. 


is the address cf a FCE rprevicusly ccnstructed 
and initialized ty the FCRFM=I parameter. 


when ne FCB rarameter is included, macro ccde 
autcmatically kuilds a new PCR and initializes 
it with values corresrondinas tc the other 
Sspecificd parameters. 


L requests a PCR to te built but not executed. 
Macre ccde ccnstructs a FCE for this macro and 
initializes it with values. Subsequent macrcs 
can reférence this PCR via the PCR parameter. 


mn stecifies the rumber af intercepticns that 
can execute concurrently for this intercert 
bathe if there are mere SVC intercepticns 
cutstandinyg than can be concurrently executed, 
the excess interceptions are queued. The 
default value for nis 1. 


4.13.2 IREMOVE Macro 


The IREX®CVE macre allows an intercerting task tc remove one cr 
all previcusly created SVC intercert paths. 
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Formats: 


Para 


7a a we ow @ 


symbol 


meters: 


PID= 


PCE= 


| VEFLRATICN | OFFRAXD 


a ee nee te Me ee Ge Gee ee ae OO 


IRE 


MOVE 
AB 


[,PCE=pointer] 


| 

| 

{ 

| 

| 

| 

} [,FEFCR=pointer] 
| 

| 

| 

{ {,FCRM=L] 
| 


is the address of the path identifier 
specifying the path teeing removed. A zero 
value in the PIL halfword removes all existing 
intercert paths. 


indicates either of two termination modes fer 
intercepted SYCs already queued for the 
intercepting task: 


~- AE indicates atert. OS/32 ahcerts all 
currently gueued requests befere rath 
remcval. 


- C& indicates controlled shutdown. 0$/32 
sé€rvices only currently queued requests 
before path removal; no requests made after 
TERM=CS ais issued can be queued cr 
processed. 


If this rarameter is omitted, AF is the 
default. 


is the address of an errer routine within the 
intercepting task. IF a run time error cccurs 
for this macro, execution branches te this 
error reutine. Tf this parameter is omitted 
and a run time error cccurs, executicn resumes 
with the instruction following the macro. 


is the address of a FCK previously censtructed 
and initialized ty the FCRM=I parameter. 
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4.13.3 IGET Macro 


if this parameter is omitted, a new PCB is 
autcnatically tuilt and initialized with 
values corresronding to the other srecified 
raraneterse 


Ll requests a PCP be Fuilt but not executed. 
A PCE as built for this macro and initialized 
with values. ‘Sursequent macros can reference 
this FCE via the PCB parameter. 


Tne IGET macre allows ar intercepting task to qet data from the 
application task whese £VC is intercepted. 


Format: 


OPERATICN | OPERAND 


symbol 


Parameters: 


ADEND= 
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RUDF=pointer 
~ACPST=rpointer 
eADFXYP=pcinter 


,o'ET=pointer 


[,FPROP=pointer] 
{[,FCF=rpointer] 
[,FCEM=T] 


| 

| 

| 

| 

| 

| 

| 

| 

|} ,STEND=pcinter 
| 

| 

| 

| 

| 

| 

{ 

| {,CCNF=addr]) 
| 


is the eddrees cf the 2DE buffer built fcr the 
intercerted £VC. 


is the start address of a data area within the 
application task whese SVC is intercepted. 
The contents cf this area are transferred to 
an interceptina task data area. 


is the end addrees of the data area within the 
application task whose SVC igs intercepted. 


4-21 


PCE= 


DON ES 


4.13.4 %$IPUT Macro 


is the start address of a data area within the 
intercerting task. This area receives the 
data frcem the aprlication task. 


is the end address of the data area within the 
intercertinga taske 


is tre address cf an errcer reutine within the 
intercerting task. If a run time errer cccurs 
for this macro, execution branches to this 
errer reutine.e 


If this parareter is omitted and a run tire 
error cccurs, executicn resumes with the 
instruction follcwina the macro. 


is tke address cf a FCB previously ccnstructed 
and initialized ty the FCR¥=T parameter. 


It this parameter is omitted, a new PCB is 
tuilt and initialized with values 
correspondina to the cther specified 
FaranmeterSe 


I reguests a FCP be tuilt hut not executed. 
A +CB is built for this macro and initialized 
witti values. Sursequent macros can reference 
this PCs via the PCR parameter. 


is an acdress that specifies that the macre is 
to be a e¢greceed call. When the call is 
comrleted, a task event interrupt occurs, 
using the reutine srecified ty the address in 
the POCNE parameter. This reutine enters with 
FO centaining the error code for the call ard 
k1 rointina tc the macro'ts parameter Elcck. 
Cnce this revtine has finished processing, it 
exits using the TFYIT macro. 


The greceed form cf the IGET macro must te 
used if an IRCIL macro was issved to the 
application task whese SVC is intercepted. 
The system cannot guarantee that the 
application task is in memory or that it can 
be rolled into memory within a reascnaktle 
time. 


The IPUTI macro lets an intercepting task put data intc a data 
area of the application tack whese SVC is intercepted. 


Formats 
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symbol 


Parameters: 


RDE= 
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| 
OPERRTICN | OPERAND 


eADeTtT=pointer 
ePTE*P=pecinter 
eolST=pointer 
eSUFND=pcinter 
[,FR&CR=rpointer] 


L,rPcR=pointer) 


[,CCNE=addr] 


is the address of the BP buffer built fer the 
interceptea £VC. 


is the start address of a data area within the 
application tesk. This area receives’ the 
contents of an intercerting task data areéae 


is the end address of the data area within the 
aprlication task. 


is the start address of a data area within the 
inte rcertine task. The contents of this area 
are fut intc the aprlication task data area. 


is tre end address cf the data within the 
application task. 


is the address of an error routine within the 
intercerting task. If a run time errer cccurs 
for this macro, execution branches tc this 
errecr routine. 


If this parameter is omitted and a run tire 
€rrcer cccurs, executicn resumes with tte 
instructicn follcwing the macro. 


is the address of a FCB rreviously constructed 
and initialized ty the FCRM=I parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 


4.13 


The 


FOR K= 


DOK E= 


5 ICONT Macro 


ICUNT 


MacCre 


values correspending te the other specified 
Faraneterse 


L reguests a PCR he built hut not executed. 
A FCP is built fer this macro ard initialized 
with values. ‘Suksequent macres can reference 
this PCP via the PCE parameter. 


is an address that srecifies that the macre is 
to be a preceed call. Vhen the call is 
comzileted, a.task event interrupt occurs, 
using the routine whose address is specified 
in the DONE parameter. This routine enters 
with Ru containing the errer cede for the 
cali, and F1 pointinc to the macro’s rarameter 
block. Cnce this routine has finished 
grocessing, it axits using the TEXIT macrec. 


The groceed form cf the IPT macro must te 
used if an IFCLL macro was issued te the 
application task. The system cannot guarantee 
that the aprlication task is in memory or that 
it can be rolled into memory within a 
reascnarle time. 


returns ccentrel of an intercepted SVC ty 


returnirg ccentrcl te an CS/32 SVC executor. 


Forn 


Para 
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ats 


symbol 


meters: 


on 


Vv 


Icv 


PERATION | OPFRAND 
NT ErP=pointer 
{,ERECR=rointer] 
[,?CP=pcinter] 


{,FCFM=L) 


is the addrees cf tre RPE buffer huilt fer the 
intercerted SVC. 


is the address of an error reutine within the 
intercepting taske If a run time errer cccurs 
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for this macrc, execution branches te this 
e€rrer routinee | 


If this rarameter is omitted and a run tine 
e€rreer cccurs, executicn resumes with the 
instruction follcvinog the macro. 


PCB= is the address of a FCB rreviously ccnstructed 
and initialized ty the FCRF=I parameter. 


If this parameter is omitted, a new PCB is 
automatically fruilt and initialized with 
values correspending to the other specified 
raraneters. 


FOR ¥= I requests a PCR he Euilt but not executed. 
A PCE is built for this macro and initialized 
with values. Suksequent macres can reference 
thic FCE via the PCE sarameter. 


4.13.6 IPRCCEEL Macro 


After an SVC has been intercerted, the intercepting task can 
issue ar IPRKOCEEIL macre te allow the aprlication task that issued 
the SVC te preceed with its execution. Until the intercepting 
task issues an IFROCEED macro, the application task is in wait 
state. 


Format: 

| | 
NANE i OFERATICN | CFERAND 
Syrbcl | IPSCCreEL { &PP=pointer 

| 
i | (,2RFOR=pointer] 
{ 
| } {,PCF=pointer] 
| | 
| } {,FCEM=L}] 
| | 
{ { ({,cCC=n) 
i | 

Parameters: 

RDE= is the address cf the REP buffer built fer the 


intercepted f£VC. 


ERRCR= is the address of an error reutine within the 
intercerting tascke If a run time errcer cccurs 


48-040 FOO 9/51 4-25 


PCE= 


FOR K= 


CCc= 


4.13.7 IROILL Macro 


for this Mmacre, execution branches tc this 
error routinee If this parameter is omitted 
and a run time errer eccurs, executicn resumes 
with the instruction followinc the macro. 


is the address cf a FCB previcusly ccnstructed 
ana initialized ty the FCRM=I parameter. If 
this parameter is omitted, a new PCB is 
autcnatically huilt and initialized with 
values correspending tc the other specified 
paranreterss 


L reguests a PCR be Evilt but net executed. 
A FCB is built for this macro and initialized 
with values. Suhksequent macros can reference 
this FCE via the FCR parameter. 


h is a decimal number srecifying the setting 
ct the aprlication task FSW condition ccde 
after the SVC instructicn execution. If the 
CC garameter is cmitted, the conditicn cede cf 
the application task PS® is set to zero. 


After an SVC is intercerted an IRCIL macro lets an intercepting 
€ the status of wne application task frem ncnrollable 
te roliable, previded that the task was established as rollatle 
This allows CS/32 to roll out a task whose intercepted 
SVC requires Lengthy precessing. 


task chany 


by Linke 


Unless an IFOLL macro is issued, an application task cannct ke 
rolled after its SVC is intercerted, even if an IPRCCEEL macro is 


issued. However, 
macro if issued. 


Format: 


symbol 


Parameters: 


U-26 


an LFOLL macro can ke issued after an IPROCEED 


OPERATICN | CEEPRAND 


RERepointer 


[,ER FCR=pointer] 


| 
| 
| 
| 
} €,fCf=pointer]) 
! 
| 
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Rbs= is the addrees of the RPE buffer built fer the 
intercepted SVC. 


ER XCR= is the address cf an errer reutine within the 
antercerting taske If a run time error cccurs 
for this macre, execution branches tec this 
errer routine. If this parameter is omitted 
and a run time error occurs, executicn resumes 
with the instruction following the macro. 


PCB= is the address of the PCP rrevicusly 
constructed and initialized ky the FCEM=L 
barameter. If this parameter is omitted, a 
new ECE is automatically built and initialized 
with values cerrespcnding to the other 
specified parameters. 


lL requests a FCP be Etuilt but not executed. 
A FCP is built fer this macro and initialized 
witn values. Surfseauent macros can reference 
this FCE via the FCER parameter. 


ry] 
o 
tad 
bat af 
i) 


4.13.8 ITEFM Macro 


The ITERFM macrce allows an intercepting task te return the 
parameter tlock of the SVC it processed tec the aprlication task 
that issued the SVC. The returned parameter hlicck can have 
updated information such as status, number of rytes transferred, 
etce 


Format: 
| | 
NAME | OFERATICN | CPERAND 
synbol IT&EERM PPR=pointer 

{,TP?E=rcinter] 
Y 

,COFY= 
K 


{,-ERFFOR=pointer] 
{,PCP=pointer] 
[,°QEM=1] 


{,CC=n] 
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Parameters: 


RDE= is the address cf the PDF buffer built fer the 
intercerted SVC. : 


TRAF= is the address of a fullword to he added to 
the task queue of the application task whcse 
SVC is intercepted. 


COF Y= Y (yes) indicates that the SVC parameter bicck 
in the REB is tc be copied back into the 
Faranmeter blcck cf the intercepted SVC. 


N (ro) inéeicates the operaticn is net 
bertcromed. Tf this parameter is omitted, N is 
the default. 


ERRXCK= is the address of an errer reutine within the 
application task whose SVC is intercented. If 
a run time error occurs for this macrc, 
exectticn branches te this error routine. If 
this parameter is omitted and a run time errcr 
cccurs, execution resumes with the instructicn 
follcwing the macro. 


PCB= is the address of a FCE rreviously cecnstructed 
and initialized by the FCRM=I parameter. If 
this parameter is omitted, a new TCB is 
autcnmatically built and initialized with 
values corresronding te the other specified 
rFaraneters. 


FOR v= L requests a PCE te Evilt but not executed. 
A FCB is built for this macro and initializes 
it with values. Subsequent macros can 


reference this FCB via the PCR parameter. 


Cc= nis a decimal number specifyinao the setting 
cf the application task FSY condition code 
after the SVC instruction execution. Tf the 


CC zarameter is cmitted, the conditicn ccde cf 
the application task PSW is set to zerc. 


4.13.9 ITRAP Macro 
The ITNAP macro allows an intercepting task to send atask queue 


item tc ar appflicaticn tack whose SVC is intercepted. The task 
queue item can ke any cf the task caqveve items supported hy CS/32Zz. 


Formats 
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UPFERAIICN | OPERAND 


symbol 


Parameters: 


RDE= 


TICs 


TRAE= 


PCB= 
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FUR=pointer 
TIU=pointer 
TRF F=peinter 
{,ERERCR=rcinter] 
{,P?CE=pointer] 
[,FCR¥=1 ] 


{,CCNF=addr]) 


is the address of the RIF buffer built fer the 
intercerted SVC. 


is the address of a fullword ccentaining the 
taskid for the taske Fefore issuing an ITEAP 
Macre with the TIL parameter, the intercepting 
task must have obtained the task identifier 
from and RIE ard rlaced it inte the fullwecrd 
locaticn. : 


NOTE 
The TID ferm cf this macre can be 


used te send a trar to a task that 
is not being intercepted. 


is the address cf a fullword tc be added to 


‘the task aqueue of the application task whcse 


SVC is intercerted. 


is the address cf an errcer reutine within the 
intercerting task. If a run time errer cccurs 
for this macro, execution branches te this 
error routine. If this parameter is omitted 
and a run time error occurs, executicn resumes 
with the instruction following the macro. 


is the address of a FCR previously cecnstructed 
and initialized ty the FCR¥=I parameter. If 
this arameter is omitted, a new PCB is 
autcmatically built and initialized with 
values corresronding tec the other specified 
karaneters. 


DON £= 


L requests a PCB be kuilt hut net executed. 
A PCR is bEuilt for this macro and initializes 
it with values. Subsequent macros can 
reterence this PCR via the PCB parameter. 


is a hexadecimal number specifying the address 
of the task Event service rcutine. When an 
I/O preceed call is ccmpleted, a task event 
interrupt occurs, using the routine whcse 
address is specified in the DONE rarameter. 
This reutine enters with RC ccntaining the 
error cede fer the call and &1 rcinting te the 
Macrc*’s parameter tLlock. Once this reutine 
has finished processing, the intercerting task 
exits from the task event trar using the TEXIT 
Macrce 


The proceed form of the ITRAP macro must te 
used if an IFCILL macro was issved to the 
application task whese SVC is intercepted. 
The system cannot guarantee that the 
application task is in memory or that it can 
ke rolled into memory within a reascnakle 
timee 


4.13210 IERRTST Macro 


The IfRFETST macro allows aa intercerting task tc evaluate errcrs 
resulting trom intercert macros in erder to branch to arrrorriate 
error handling routines. 


Format: 


symbol 


Parameters: 


LERKATST 


OPERATICS | OFFRFAND 


xxXx=rpointer 


xX=rointer 


OCH=erpocointer 


| 

| 

i 

| 

| 

| 

|} ELSF=pcinter 
| 

| 

| 

{ FORM=L 
| 
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Xx= is a two-character alrchabetic etring 
specifying cne of the error ccedes fer the 
intercefrt macros. See Table W-?,. 


Pointer epecifies the address of an intercepting task 
ercrcr rcutine that handles errors having a 
returned error code identical to the ocne 
specified ry the xx parameter. For instance, 
an IERRTST macro might include these 
farameters fer evaluating an IPUT macros 


IERKIST A=address,NT=address, FD=addrees 


These fcur rarameters erfecify error rceutine 
addresses to branch to whenever the returned 
errer ccde equals Al, NT, or ED. 


ELs k= is tre address cf an €rror reutire te te 
executed for errors other than those specified 
in the xx parameter. If this parameter is 
cmitted, either of the fcllowing acticns 
ecccurs fcr returned errers: 


- Ti the returned error code ccrresrcnds to 
tke cne specified ty the xx faraneter, 
execution tranches to a srecific errcr 


reutine. 

- If the returned error code dees: nct 
cerrespornd tc the cne specified Ey the xx 
Larameter, execution branches to the 
instructicn immediately fcllowing the 


IERREIST macro. 


PCE= is the address of a FCB previcusly ccecnstructed 
and initialized hy the TCEM=I parameter. If 
this farameter is omitted, a new FCB is 
automatically built and initialized with 
valué€s corresponding tec the other specified 
raraNneters.e 


FORK %=L I reguests a PCR be Etuilt but not executed. 
A PC28 is built for this macro and initialized 


with values. Suksequent macros can reference 
this FCB via the PCR parameter. 


4.13.11 SRIB Macro 


The SRDE macro is used to define a setructure containing the 
symbolic nanes fcr all cf the Rf fields. It is recommended that 
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symbolic names be used 


coding the hexadecimal cffseéts 


Formats 


[symbol] | SRDE 
| 


4.14 


to reference the PDP fields instead cf 
to the fields. 


| 
(4 OFEPRND 


SAMPLE SVC INTERCEPTICN PROGRAM 


The following program uses SVC intercepticn software toe intercert 


SVC 1 tc the dévice MAG1. 
Points cut 


>SiKER 
*Add an KLE buffer address 


>LA 


O,BUFLIST 


*Create the Intercept Fath 
PICnEATE NAMESINTNAYE, 
DMCTE=RX, 


>CONTEOL=FC, 


>SVC=(1), 


D>EXEC=INTRTN, 


>BUFFERI=BUFLIS1, 


>PILC=PATHID, 


>ERFOR=EONSCUT 


‘Fach time SVC 1 is issued, 
“SVC 1 call intercerted”. 
with a device unavailable error code 


the program 
The SVC 1 terminated 


(Y"AO"). 


is 


YDEFINES AN RDR STRUCTURE 
to the RIF buffer address liste 


7ALOPD TRE EYDRESS OF THE RDE 
INTO REGISTER C 


“ATT THF ADERESS OF THE 
Te. “ERE CIRCULAR LTSst 


RDP 


7SPECTIFIFS FD FCR PEVICE NAME 
/SPECIEIES RESILENT-EXISTENT MOLE 


/SIVES INTERCEPTING TASK FULL CCNTRCL 
OVER INTERCEPTED SVC 


7SPEFCIFIES THAT ALL SVC 1 TYFES ARE 
TO BE INTEFCEPTED 


POINTS TO THE EVC EXECUTOR ROUTINE 
TEAT SERVICES THE INTERCEPTED SVC 


ASSIGNS POINTER TO CIRCULAF LIST 
CONTAINING ADUPFESSES OF FREE 
RDE BUFFERS 


/DEFINES DATA AREA FOR 
LEENTEELRE 


INTERCEPT PATH 


/DFSIGNATES ERRCR RCUTINF TC WRICH THE 
PRCGRAM WILL BRANCH TO IF FUN-TIME 
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ERFOR CCCURS IN ICFFATE MACKC 


*Enable task event trar sc task can go inte trap wait fer inter- 
cepts tc occur 


2LiIcw “LORD TSW WITE WAIT STATE SET 

PTEIS, WI /TRSK EVENT TRAFS ENABLED 
>Come here if error occurs in ICREATE macro 

>BOKBOUT SVC 3,1 “ /ERIL TASK CN ERROR 


>Allocate data area for ICREATE 


> ALIGN 4 

D>ININANE CC Cc" Py /NCDE NAMF 

> CC C*MNAG1° /JDEVICE NAME 

> CC Cc? /FILE NAKFE 

> CC c° . JP ATENSTON 

>BELLIST DLIST 1 /OESIGNATE AREA FOR 1 REE IN CIRCULAR 
LIEeT 

>REE TS RDE.Pe+20 ALLOCATES SIZE OF RDB + SVC 1 FARAFETE) 
BLCCK 

>PATHID DSz /DESIGNATE AREA FOR ICREATE MACEFO TC FU‘ 


THE PATH IL 


*TRAP EVENT SERVICE ROUTINE 
*THE FCILOWING FCUTINE IS EXECUTED WHEN AN SVC IS INTERCEPTED 


PINIRTN SVC 2,NOTIFY 7ZLAG MESSAGE THAT AN SVC WAS INTER- 
CEPTED 


LHI O,X*ACOO* /GET STATUS FOR INTERCEFTEN SVC 1 


STk O,RDE.FE+2°1) SSAVE SVC 1 STATUS IN STATUS FIELD 
OF PDE 


*TERMINATE THe INTERCEFTED CALL, CCFYING THE FOLIFIED SVC 
“PARAMETER ELCCK IN THE RDS BACK OVER THE USER'S SVC FARAMETER 
*BLOCK. 


>ITERM FDB=(1),COPY=Y 


D>TEXIT EXIT THE TASK EVENT ROUTINE 
*ALLOCATE DATA AREA FOR EVENT SERVICE RCUTINE 
> ALICN 4 
? NOTIFY [8 0,7,0,22 
> DC C*svce 1 CALL INTERCEPT FD® 
> END 
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CHAFTER 5 
OS/32 SUPFCRIEL I/C DEVICES ANT 
DEVICE DEPENDENT AND INDEFENDENT INFORMATION 


5e1 INTRODUCTICN 


All I/S5 requests are made via J/O macrose This chapter discusses 
the functicnal aspects cf the devices suprorted ty CS/32Z. 
Specific device dependent informaticn (supported functions, 
status returned, and fcrmattine perferred) is included. 


OS/32 devices and files surrort ASCII formatting, proceed I/sC, 
sequential access, uncenditional and conditional preceed, and 
uniform vertical torms control (VFC). DTevice ccdes, ranging frem 
QO through 2&5, are asscciated with Ferkin-Flmer supported devices 
and are listed in the CS/32 System Ceneraticn (SYSCEN) Reference 
Manual. 


5e2 UNIFORF VFC 


VFC suprort allcws all CS/32 ASCIT outrut devices to comply with 
American Naticnal Standards Institute (ANST) forms centrcl 
standards tcr FCRTKAN ard CCBCIL rrocramminga. 


ANSI requires that the logical vertical position of a form always 
match the ghysical fpositicn of the form when it is sent te. an 
outrut device, including interactive devices. In adcditicn, 
interactive devices must be able to intermix the following 
operaticns in a consistent manner: 


o read with VFC, 

o xcead without VEC, 

o write with VEC, and 

re) write without Vrc. 

Perkin-Elmer VEC support complies with the FORTPAN carriage 
control character set defined ky ANSI ¥3.9-1978 for forms centrcel 
before printing. If an I/C device is used that does net support 


a certain VIC character, inputting that character will activate 
a single lire teed tefcre printing. 
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5-3 MIXED VFC AND NON-VFC OPERATICNKS 


VFC and oncn-VEC I/0 cperaticnse perform Similarly. Fead 
operaticns alternating with write creraticns, which have single 
line spacing (before or atter), are on alternatins lines. 


Read with and without VEC orferaticns start at the current 
physical cursor positicn and end with a carriage return (CR) and 
Single line feed (LF). The relationshir cf logical and physical 
cursor pcsition is the same before and after a read operaticn is 
performed. 


The following examples describe mixed VFC and non-VFC I1/0 
operaticns. Fach e€xample is kased cn the previcus one€. 
Initially, the lcgical and rhysical positions of the cursor are 
set to line 1.2 sote the changes in lcgical and physical curser 
positions ard line numbers as each I/O cperaticn is rerfcermed. 


The abkEreviations used in the examples are as fcllowss: 


ABZ REVIATION MFANING 
CL Current logical rosition 
PL Frevicus legical position 
cP Current shysical position 
FP Frevicus physical peositicn 
Cr Carriage return 
Le Tine feed 

Example 1: write with cne line serace hefore printing 


Arter spacing, Cl and CF meve tc line 2, and PP and PI are 
situated at line 1. The characters that result from this 
operaticn are printed on line 2. Ffter printing, a CR/IF is 
performed, moving Cr te line ?. The resulting cursor rfesiticns 
are: 


CUESOR f DINe 34 CHARACTFFES 
POSITIONS | NUNEER | PRINTED 
PLe FF OJ 4S 
CL | < | EXAMPLE 1 FRINT 
CP ! 3 | 
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Example 2: Woite with cne line srace tefcre printing 


Atter sraciny, FL moves to line 2 and PP to line 3. ¥hen PL and 
PP are net located cn the same line, PP must roint Lack to FL £cr 
the I/C orferaticn te be perfcermed. The characters that result 
from this oreraticn are printed on line 3. Both CL and CF are 
then mcved te line 3. Atter printing, a CF/LF is rperfcrmed, 
moving CFP tc line 3. The resuitine cursor rositions are: 


CURSOR | LINE | CHARACTERS 
POSITIONS | NUMBER f > PRINTER 
PL [> 2 | EXAMPLE 1 FRINT 
| | 
PF, CL i 23 | EXAMPLE 2 FRINT 
| | 
CE 1 4 i 
Example 3:3 wWwroite with cne line srace after printing 
Befor2 crinting, PP points to line 3 as shown in Fyryample 2. The 
characters printed asa result of the I/C oreraticn are printed 
on line 3, which overprints the outrut from Example 2. After 


moviny one line space, CL and CP are rositioned at line 4. The 
resultirg cursor positicns are: 


CUESOR {| LINE | CHAPACTFFS 
POSITIONS | NUMEER | PRINTEC 
PL } 3 | EXAMPLE 3 FRINT 
| | 
PPPs. CL, {} 4 { 
CF | | 
Example 4&4: write with cne Line srace after printing 


Before rgrinting, PL and FE are gresitioned at line 4. The 
characters printed as a result of the I/% oreraticn are printed 
on line 4. Arter meving cne line srace, CL and CP are resiticned 
at line 5. The resultirg curser resiticns are: 


CURSOR |} LINE | CHAP RCTERS 

POSITIONS | NUMBER | PRINTED 

PL, PP i 4 {| EXAMPLE & ERINT 
| 

CL, CP 1 5 { 
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Example 5:3 write with no VFC 


After printing, PL and FEF are fypesitioned at line 5. The 
characters printed as a result of the I/O operaticn are rrinted 
on line 5.2 Atter CR/SLE, CL ani C® ere reositicned at lire 6. The 
resulting ctrsor fositicns are: 


CUFSOR | LINE | CHARACTFRS 
POSITIONS | NUMBER | PRINTFD 
PL, PP | 5 | EXAMPLE 5 FRIKT 
I | 
CLy Ce | 6 | 
Example 6: Write with cne line space tefcre ftrinting 


Atter spacing one line, FL and FP are rnesitioned at line 6 and CL 
and CE are rfrositioned at line 7. The characters rrinted as a 
result of the I/0 operaticn are printed cn line 7. After CR/LE, 
CP is pcsitioned at line 8, while CY remains at line 7. The 
resulting ctrsor positicns are? 


CURSOR | LINE | CHER ACTFRS 
POSITIONS { NUMEER | PRIKTFD 
PL, PP {| 6 | 
| | 
CL | 7 | EXAMPLE & FRINT 
| | 
CP | 8 | 
Example 7: write with ne VEC 
Before rrinting, PP peints back to line 7. The characters 


printed as a result cf the I/C creraticn are rrinted cn line 7, 
which overrrints the cutgput from Example 6. PF, CL and CF are 
moved te line 8. The resultina cursor positions are: 


CUFSOR | LINE |  CHARACTEFS 
POSITIONS | NUMBER | PRINTEL 
PL | 7 | EXAMPLE 7 ERINT 
| 
PP, CL, | 8 | 
CP l 


Example 8:3 Xead with VEC 


Befcre characters are read with VFC, PL and PP are rgesitioned at 
line 8. As a result of the I/C oreraticn the characters are read 
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from line Be CL and CF are meved to line 9. The resulting 
Cursor positions are: 


CUESCE { LINE | CHARACTFES 
POSITICAS | NUMEER | REAP 
PL, FE | 6 | EXAMELE & FREAD 
| : 
CL, CP { 9 | 


Example 9: Read withctut VEC 


Before characters are read withcut VFC, PL and FP are rositicned 
at line 9. AS a result cf the I/C oreraticn the characters are 
read frcem line $. CL and CF are meved to line 10. The resulting 
positions are: ; 


CUBRSCE } LINE | CHARACTEES 

POSITIONS | NUKBER | READ 

PL, PP | s {| EXAMPLE 9 FEAD 
| 

CL, CP { 10 i 


Example 10:3 write with cne line srace Lefore printing 


Before spacing cne line, FL and PP are positioned at line 10. CL 
and CP are positioned at line 11 after moving one line space. 
Tne characters printed as 2 result of the I/O operaticn are 
printed on line 11. After CR/JF, CE ig cositioned at line 12. 
The restlting cursor pesiticns are: 


CUFSCR | LINE | CHARACTERS 
POSITIONS | NUMPER | PRINTFE 
PL, PF} 40COCdD 
CL | 11 | EXAMPLE 10 PRINT 
CP | 12 | 


Example 1171: Read witn VFC 


Before reading with VFC, PF points kack to line 11. As a result 
of the I/O cperation the characters are read from line 12. After 
CR/LF, CL is pesitioned at line 12, and CP is rfositioned at line 
13. The resulting curscr pecsSitions ares: 


CUBSOR } LINE | ChKARACTERS PRINTED 


in 
' 
ui 
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POSITIONS | NUMEER | EXT BREED 


PL 1 11 | EXAMPLE 10 PRIKT 
| 

PP, CL | 12 | EXAMPLE 11 BRAT 
| | 

CP | 13 | 


Example 12: Write with cne line space tefore printing 


Before spacing, PP points Eack to line 12. After meving one line 
space, CL ard CF are resitioned at line 13. The characters 
printed as a result of the I/% onperaticn are printed on line 13. 
Aiter CE/LF, Ch is positioned at line 14, while CL remains at 
line 13. Thke resulting curscr rositicnse are: 


CURSOR } Live | CHAR ACTFES 


POSITIUNS | NUSEER | PRINTEL 
| 11 {| EXAMPLE 10 PRINT 
| | 
PL | 12 
| | 
PP, CL } 13 | EAAMPLE 12 PRINT 
| | 
CP 1 14 | 


5e4 CARD ECUIPMENT 


Ferkin-Elmer card readers can accommodate a fixed recerd length 
of 80 bytes (ASCII), 12¢ bytes (binary), or 160 bytes (image). 


During read ASCII operaticns, each card column (12 tits) is 
converted into one 8-btit ASCII character. Yllegal ccdes are 
converted into the nuli character (¥'0°%*) indicating an errer has 
OCCULLe Ge 


During read binary cperaticns, each pair of card columns (12 tits 


each) is ungacked into three bytes having the fcllowing format: 


First card cclumn Second card celurn 


117,70; OF TJ] 2] 3) ST Ef Of TI BF SPIT114F7101 OF TP 2t 3] uy St 6] 7 


During read image operaticns, each colurn is converted intc cne 
halfword in the followirg fermat (U=undefined): 
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1 Uf Ul17P,1C] Of} 17 21 2] Ul Cl St St 6] 7] 8] 94 


ww eee er ewe eeanae eee ee See we ew ws eS we |] |S ww ow ww eS ww ew ee we we oe 


Bytes: 

0 15 
STATUS MEANING 
xX" co°* Ncermal end of transfer 


| 
{ 
| 
X*°AO* | Device unavailable; reader net ready 
| 
i 
{ 
| 


x E2* Hcpper emgty cr stacker full 

X* eye Data transfer errer {read check or pick 
check) 

x CO" Illeyal ftnction 


The tranSlaticn for an ASCII read is accomplished through a 
translaticn tatle. The devices without hardware translaticn 
translate 029- cr OZ6—-ccMratible Hollerith code to 2=-fit ASCII 
code. Scurce sysgen options include translaticn cf 029- cr 
O26-comratitle Hollerith code te FRCLIC cade. The hardware 
translation matches that cf the O29-comratitle Hellerith 
translation. 


Card réader/punch devices supported ty Pperkin-Flmer 32-bit 
computers acconmodate fixed reccrd lengths of 8C Lytes (ASCII), 
120 bytes (column binary), and 16% hkytes (imace). 


During read ASCII operaticns, each card column (12 bits) is 
cenvertéed into one E-bit ASCII character. Illegal ccdese are 
converted irto the null character (X*'0C") indicating an errer has 
occurred. 


During read binary cperaticns, each rair of card columns (12 bits 
each) is unpacked into three bytes having the fcllowing fermats 


First card cclumn Second card column 


anew ETeE ee we ew ee BE eee wwe Oe Oe eee @eeaw eeewn Bee DB Oe Be Bees Be @e oe we ee 8 @ @ we a ow 


1174707 OF TP 2] 3) Sf EL €F TI BY Sf1714710] OF AP] 2] 3] SY Sf Ef 7] 


During read image operaticns, each card column (12 bits each) is 
placed into a halfwerd in the fcllecwing format: 


1 O} OF Of CJ17]}10] O] 1] 2] 37 Sf Sf EF FI BI SI 


tn 
9 
~J 
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‘During worite ASCII cperaticns, each hyte of data is translated 
from ASCII into a 1Z-bit Ycllerith ccde. Nepending on the device 
code chcesen, the following can cccurs: 


re) All data is punched and printed. 
©o Data is bunched cnly. 


o Cf each 160 Eytes of data accepted, the first 89 tytes are 
punched while tne second 8O tytes are printed. 


During werite binary operaticns, each 3-Fyte group is packed into 
two columns on the card in the following fermat. Nothing is 
printed cn top cf the card. 


During write image cperaticns, the low order 12 tits of each 
halfword are punched acccrdins te the follewing format. Necthinrg 
is printed cn tcp of the card. Pits O through 3 are ignored. 


Pot Gb F Ft2caty OF AP 24 37 St SP ef Ft at Fy 


ese OOO OE eZ Oe S&S Bees Gene en GS Bees £82 28 wee 2 ee & 2 ee we @ = 


| WEANING 
wee ee | er tt me mm mm mnt meee ene nt eren- 
| Nercmal end cf transfer 
X'#o® | Levice unavailable 
| Hcpper emrty, stacker fvll 
|} Data transfar errer 
| Lllegal function 


The translation for ASCII creraticns is accomplished through a 
translation tatle. The standard translaticn is 8-rit ASCII ccde 
tc O02¥-compatible Kcllerith code. 


Source sysgén og¢tions include S-bit ASCII cede to O264-cempatikbtle 


Hollerith code and ailsc ESCIIC cede te C2f- or 02?9-ccmpatiLbkle 
Hollerith ccde. | 
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SoS TELETYFE CITY) REALER/PUNCE 


Ferkin~Elmer TTY reader/rpunch devices surrort read and write 
ASCII, read and write binary, and read and write imase 
operaticnse Variable length records are also acconmodated. 


During read ASCII operaticns, an ¥-C®% character is output te turn 
the reader cne Tne tare is read in blocked mode so data is not 
printed on the printer while it is kteing read. Leading tlanrk 
frames and delete characters are igqnored. Data is masked to 
7-bit ASCII. The transter is terminated cn buffer full cr 
carriage return, whichever: ccecurs first. On termination cf the 
transfer, the tape is advanced te tre next delete character cr 
blank frame. aAn X“CFF character is outrfut to ston the tape. 


Puring tinary read cperaticns, an Y¥-CN character is cutput to 
turn cnr the tape. The tage i¢ skirped until the first nonblark 
frame is found. If the first nonklank character read is an 
X°FO*, the following frames are read in until the user huffer is 
full. The characters read in are in unzoned binary fermat. If 
the farst nontlank character read is not an X¥'FC', zoned kinary 
mode is assumede In this case, the characters are read, stripred 
of the zones, and packed into the user tuffer until the Euffer is 
full. In this mode, the only valid punches are X*9C*, xX‘*&1° 
through xX*&4*, and X°95* throuch X'OF*,. Cther characters are 
ignored. On buffer full, the tape is advanced to the next blark 
frame in zoned binary wmcde. In uwnzened tinary, the first 
character transferred to the user buffer is the character 
following the X*FO" character; while in zcned binary, the first 
nonklank frame is transferred (after strirring and racking). 


During read image operaticns, none cf£ the ahove fermattinrg 
Operaticns are performed. !'n X-CN character is cutnut to turn 
the tage on, and data is read until the user buffer is full. The 
X-OFF character is then cutrut to turn the tape off and the 
transfer is complete. 


During write ASCIi cperaticns, the driver outputs a 2UPROUT-TAFE 
RUBOUT- FUEDLT sequence in order to initialize the 11Y 
reperforatore Eight frames of tTlank tape are output as leader, 
the user data is outrgut until the huffer is emnty, or carriage 
return, Whichever cccurs first. The driver ensures that a 
CR-LF-TAPEL CPEF-EUBOUT Sequence terminates the record. 


During write tinary orerations, the driver cutputs a 
RUSOUT~TAPE-RUECUT-RUSCTT Sequence, follcwed ry eicght blank 
frames cf leader. The user buffer is cutrut, translating each 
byte arto two frames of zoned binary data. The transfer is 
terminated when the buffer is empty. The driver outputs a TAFE 
OFF-RUBCUT sequence. 


During write image operaticns, none of the akove formatting cr 
control cperaticns are rpertormed. The user buffer is cutrut 
until the bruifer is emrty. 


in 
i] 
wo 
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STATUS | —  MERNING 
| Normal ccengletion 
| Device unavailable 
x*64° | Data transter errcer 
J break detected during transfer. Timecvt. 
j Illegal functicn 


On ASCII or image write, it is rossible to inadvertently turn cff 
the punch by outgutting a TAPE CFF character. Cn image write, it 
is the resgpensikility cf the user tc place the necessary centrecl 
characters, such as TAPE and TAPE CFF, in the user buffer to 
control the operaticn of the tare. 


Since the readexr/punch rgertion cf the TTY is connected tc the 
Keyboaru/printer portion, only cne cf these devices can be active 
at atimee On ASCII write, the data runched on the tare is also 
printed on the rfrinter. 


5-6 TTY KEYBOARD/PRINTER 


Perkin-Elmer TTY keyboard/rrinters acccmmodate variable length 
records and can Ee interfaced tc current locp devices. 


In read ASCII oferations, data read is masked to 77-bit ASCII. 
Data is read until the Euffer is full or a carriage return is 
found, whichever occurs first. Yron termination, a carriage 
return/line teed (CR/LF) sequence is sent te the printer. Tycing 
CNTKEL kX catses the line ingut to ke ignored, a CR/IF sequence to 
be outpet, and the rea? operaticn tc he restarted. Tyning CNTRL 
H causes tne previous character entered te te ignored. 


In write ASCII creraticrs, the tuffer is scanned tc eliminate 
trailing hilanks. Data is then outrfut until the buffer is 
exhausted or until a carriage return is found in the data strean. 
AR line feed if automatically arrende«d te the detected carriage 
return; cr if ne carriage return is detected, a CR/IF sequence is 
outbLute 


During image 1/C, nene cf the akceve formatting actions cccutur. 
The amcunt of data requested is tyred out or read in, withcrt 
masking to 7-hit ASCII, eliminating trailing blanks, checking fer 
CNTRL X or CNTRL H characters, cr detecting or appending carriage 
returns cr line feeds. Cn image read, however, a carriage return 
is detected as an end of line sentinel. 


STATUS | MEANING 
eee aw woee = [So SSS SS see h See SSSR eS SS Sas Se Se ee SSeS 
X*COoO°* | Wermal ccerrpletion 

X°G2° | Timeout or line hreak 

Xx* ey" j Unreccverakle errcr 

X* AO* | Device unavailable 
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While tne reader/punch cf an ASF TTY is treated as a separate 
device, it cannot ceerate simultanecusly with the 
keyroard/printer. 


5.7 PAFER TAPE EQUIPMENT 


Variable record lengths are surprorted by Perkin-Flmer parer tare 


devices. Turing read ASCII cperations, leading blank tare and 
delete characters are ignored. Pata is masked to 7-hit ASCII. 
Carriage return termirates read. Cn termination, the tape is 


advanced until either a blank tepe cr a delete character is read. 


During read binary cperaticns, tape is advanced until a nenzero 
character is réads If this character is X‘*FG*, the tare is read 
until the buffer is full (Cunzoned hinary). If the first nonzero 
character ais net X‘EFC*, the tare is treated as a zoned tinary 
tape Fach two characters are strirred of their azcne, rerged 
ints one byte, and placed in the tuffer until the buffer is full. 
On butter full, the tape is advanced until blank tape is found. 
In zoned pinary mcde, the cnly valid characters are: xX°9C°, 
X°61* = XK*H4" and X*95° = X*"9OF®*, Fh1ll cther characters cause the 
transfer to end with unreccoveratle status. 


During read image oreraticns, the tape is read until the tuffer 
is full. 


During write ASCII operaticns, eicht frames of bliank tare are 
OUutEUt. The user hufter is cutput up to CFrut not including) 
Carriage return cr until buffer emrty. CR/IF is then output. 


During write binary cyerations, €iacht frames of blank tare, 
followed ky the character X‘FOS, are output. The user Luffer is 
output until the buffer if emrty. 


During writé image cperatizcns, the user buffer is outrut until 
the buifer is emrty. 


STATUS | MEANING 
X*CO* | Nermal ccnpleticn 
X* AC® | Device unavailable 
KP E2* | Timeout 
X* 64" | Transfer error or invelid zone character 
X*cu* | Illegal function 


5-8 LINE PRINTERS 


Perkin-Flmexr line printers suprert variable reccrd lengths up te 
132 bytese 


During write ASCII operations, the user buffer is output until a 


carriage return is found cr until the bhuffer is empty. At tuffer 
termination, the syster taxes @]11 necessary action to ensure that 
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the butrer is pranted and the perer is spaced upward one line. 
If form-tfecd cr cther paper motion is desired, the arpropriate 
Characters must argerear in the user tuffer. 


During write image operaticns, the user buffer is output exactly 
as in memcry.e The system dees not take action to ensure that the 
data is printed cr that the rarer is prcererly moved. The user 
should te familiar with the characteristics of the farticular 
device reing used. 


STATUS | “MEANING 
X*CO"* | Nermal cempletion 
X*°AO* | Device unavailable. Tevice nct ready 
| Eecrm errer 
» Gad ae | Levice tirecut 
Xx’! | Device interlcck 
x CO {| Illegal function 


Although the lew and high screed line printers have different fcerm 
control characters, the sequence carriage return, xX*01°, causes 
a new line te be Started on each printer. This sequence, used 
foc write ASCII, allows program cemratibility using the same 
driver. 


509 TAEE CASSEITE 


Variable length records are supported ty Ferkin-Elmer tare 
cassettetSe During aingut, ASCII, binary, and image modes are 
identical. Data is read from the cassette into the user huffer. 
The traneter terminates when the buffer is full or at end cf 
record, whichever ccmes first. If the record is longer than the 
buffer, error status is not returned. Parity errers in the 
uncead fart of the record can he detected. If a parity errer 
occurs, five retries are attemnted hefcre errecr status is 
returned. hhen @ barity error status is returned, the tare is 
poSitioned in the interreccrd gar following the record in error. 


During cutprut, ASCII, tinary, and image mrodes are identical. 
Data is written trom the user buffer until the buffer is emrty. 
The system retries five times con parity errors. 


ST#Tus | NEANING 

X*CO*® | Nermal completion 

X*?0O° | Device not ready; tape failed to move at 
| €tart of reguest 

X*sOo° | £nd of tare cn read, write, or write file 
| mark 

X°E€8* | End of file 

X*@u* | Device became unavailable during a request 

x 22° | vata transfer errcr after five retries; 
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| |} timecut 
X*c8° { end of file/end cf tare 
xX*cC* | Illegal tenction 


The driver Generates an end of tare conditicn, whether the tare 
is positioned at the keginning cr at the end of the reel. It 
must be assumed from the last orferation what position end of tare 
is actually referring tc.e 


Since the two drives on an intertarpe cassette share logic, ecnly 
one drive of a cassette pairs Cede, X°45* and X*°55"*, can te 
active at a time. 


Continucus mode cperaticns are usec tc pass requests tc the 
drivec within the tine required (10 milliseconds for read; 30 
milliseconds for backspace). 


52-10 MAGNETIC TAPE 


Variable length recerds are supported Ey Ferkin-Flmer magnetic 
tape devices. During ifput, data is read into the user ruffer 
from the magnetic tape. The transfer ends cn buffer full or end 
ot recerd, whichever comes first. If the reccrd is lenger than 
the user buffer, error status xX*8?* ais returned. This errcer 
Status code alsc indicates farity error. On a parity error, five 
retries aré attemeted before error status is returned. After a 
karity errcr, the tape is positicned in the interreccrd gap 
followirg the record with the errcr. 


During cutput, data is written frem the user huffer tc the 
maynetic tape until the buffer is empty. On parity eErrcr, an 
extended record gap is written and the write is retried. 


For read and write requeste, ASCIT, hinary, and imace requests 
are identical. 


STATUS | MEANING 
— an oe a ae on | a wen emer ee enw wee tw own en wee se wee e wee es ewe oe owe we & 
X"co* |) Ncrmal conpleticn 
X*° 40° | Device net ready: tare unavailable at the 
| Start of reyjuest fer data transfer 
X*SO° | End of tape; request caused the reflective 
| marker at the beginning cr end of tare tc 
| ke sensed 
x*&8°* j} End of file; filemark detected during request 
X*€U*° | Device became unavailable during request 
X62" | Data transfer errcr after 5 retries; cr record 
| transferrei is lenger than user tuffer 
X*CO*® | Tilleygal fenction 
x" csB* | End of file detected cencurrently with end 
i 


cf tape marker 
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The driver aSsumes the tase is at end of tare if end of tare is 
detected on a write request. Cn a read cperation, end of tare 
may be detected on a different record than cn a write cperaticn 
because of mechanical tare positicning. If rewind is issued at 
beginnirg ci tape, the criver returns nermal status. Ensure that 
the tape is loaded at beginning cf tare unless scme cther 
conditicn is exrected. 


5-11 DISK STORAGE 


Perkin-Elmer disk devices surport variable length records. 
During input, a current sector pcinter is maintained. Ona 
sequential read, data is read inte the user buffer from the disk, 
Starting at the current sector, until the buffer is full. If an 
attempt is maue to read reycnd the end cf the disk, end of medium 
(E9M) status is returned. Cn a randem request, data is read frem 
the isk starting at the sector srecified by the randcm sectcr 
address passed with the request, until the rFuffer is full. If an 
attempt is nade to read breyend the end cf the disk, EO™ status is 
returned with data transferred. ASCII, binary, and image 
requests are identically treated. 


During cutput, data is written from the user tuffer to the disk, 
Starting at the current sector (fcr sequential writes) cr at the 
specified sector (fcr randcm writes), until the buffer is empty. 
Attempts to write past the end cf the disk cause FCM status to te 
returned. In this case, nec data is transferred. 


Errors cn data transfers cause the creration to he retried 
several times Ltefore returning errcr status. 


All data transfers start cn a sectcr boundary, tut can end cn any 
byte of a Sector. 


not within the tcunds of the transfer 
requested 


STATUS ] MEANING 
ee ee oe o |-- eee mwa nw ane ene nen ewe we EB ew ee wee Ow ee ee ewe oo 
X*Cu* | Nermal ccempleticon 
X*°AO® | Request cculd not be started, device not 
j xready 
x*so* | ECM; transfer .enrds heyond the end of the 
| disk 
X°€4" | An unrecceverable error cccurred cn a 2z.5, 
i ©&, ocr &CMb disk, and retry efforts 
} failed 
X*é2° } A recoverable error was detected ona 
| Ze5, 5, cr 4CMb disk 
y aie oo Nhe } Write attempted te pretected drive 
X*°FF* | Selector channel (SELCH) end address was 
| 
| 


If an error conditicn cther than cone cf those mentioned abcve 
occurs, the device deperdent status is set to the hardware status 
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of the file controller, disk drive, or SELCH, depending upen the 
error ccndition which prevailed. 


The file Manager uses the moving head disk driver. A user 
program cannot invoke the disk driver unless it is an e-task. 
For uetasxs, the disk is accessed via the ccntiguous or indexed 
file hardlers. 


5-12 FLOPPY DISK 


Variable length recerds are supported by Perkin-Elmer flerry 
disks. During input, a current sector rfointer is maintained. Cn 
a sequential read, data is read from the disk starting at the 
current sector into the user buffer until the buffer is full. Cn 
a candcnrm request, the data is read from the disk starting at the 
sector specified ty the random sectcr address passed with the 
request, until the Luiter is full. If an attemrt is made tc read 
beycnd the end of disk, EC” status is returned with data 
transferred. ASCItL, binary, and imece requests are identically 
treated. 


During cutput, data is asritten frem the user buffer to the disk, 
Starting at the current sector rointer (for sequential writes) cr 
at tne specitied sector (for random writes), until the buffer is 
empty. It an attemgt is made tc write heyend the end of the 
disk, tC status is returned with no data transferred. ASCII, 
binary, and image requests are identically treated. 


Errers cn data transfers cause the creraticn tc be retried ten 
times kLefore returning errcr status. 


All data transfers start on a legical ?564-tyte sector boundary 
(two physical sectors cn the florry). Transfer can end cn any 
byte of a Se€Ctor.e 


STA&TUS | MEANING 
a | nae ene eww ewer Beene ween Oe ee BD Ow ee Ee we eee 
x*cc’ | Nercmal ccnpletion 
X* fo? | Fequest cculd not be started; device not 
| ready 
x*co* | £CM; transfer ends heyond the end of data 
X¥*Co* | Illegal function 
X's4* | All device errors other than data transfer 
{ error 
X22" | Data transfer errcr after ten retries 
| 


Write preretection viclation; timeout 


The floppy disk driver is desianed fer use ty the file manager. 
A user precgram cannot invcke the driver unless it is an e-task. 
For uwstasks, the disk is accessed by the centiguous or indexed 
file handlers. 
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5e13 VIDEO DISFLAY UNIT (VLU) TERMINALS 


Variable lergth recerds are surrorted ty all Perkin-Fimer VIU 
terminals. 


During read ASCII operaticns, data read is masked tec 7-tit ASCII. 
Data is read until the tuffer is full cr a carriage return is 
found, whichever occurs first. Upcn termination, a CKE/IF 
sequence is sent to the screens CNTRIL X causes the line ingut to 
be ignored, an LF/CR sequence te be outrut, and the read 
operaticn to te restarted (depending on the device ccde). The 
backspace character or CCNIROL BP causes the previcus character 
entered to le ignored. 


During weriteé ASCII cperaticns, the tuffer is scanned to elininate 
trailing blanks. Data is then sent to the VDU until the kufter 
is exhausted cr until 4 carriage return is found in the data 
stream. A line feed is autcmatically appended to the detected 
Carriage return; cr if ne carriasce return is detected, an LF/CR 
sequence iS SE€nt to the terminal. 


During image I/C, nene cf the above fermatting actions cccur. 
The amcunt of data requested is typed out or read in, withctut 
masking to 77-bit ASCII, eliminatinoe treiling blanks, checking fcr 
backspace or CNTRL H cnaracters, or detecting or appending 
carriage returns cr line feeds. Cn image read, however, an ASCII 
CR is detected as an end of line sentinel. 


| Nermal ccnmpleticn 

X"E&2 | Timeout or break 
| Unreccverakle I/° errer 
| Device unavailable 


Depressing the Ereak key wrile readcing or writing causes X*82°* 
Status tc be returned. This is fully ccmpatible with the TTY 
keyboard printer driver; the ESC key has the same results. 


When writing to the VEU in image mode, it is pessitle that the 
last character in the user tuffer will he lost. Include an 
additional character in the buffer after the last valid character 
transmitteude EKubout, X*FF*, is recommended. In format mode, a 
rubout character is autcmatically transmitted after the CR/IF 
sequence. This character dces not apnear cn the screen. 


5e14 6-LINE INIERRUPT MODULE 


Interrupt simulation (SINT) is the cnly attribute suprerted ty 
the Perkin-tlmer 8-lire interrurt mcedulee The module provides 
the processcr with eight interrupt linés frem external equipment 
and ackrowledges interrurts on a gricrity basis. Any line can te 
selectively enabled Or disahled. Several lines can _ te 
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concurrently enabled. An interrurt does not transfer any data, 
nor is any status yiven. 


5-15 DIGITAL MULTIPLEXCR 


ASCII ogerations are net Supported ty the Perkin-Elmer ¢igital 
multiplexor. Uuring inrut, the seccnd Eyte of the randcm address 
field contains the segment and point number to be read. Data is 
read f£rem the pcint specified until the buffer specified by the 
starting and ending address is full. 


During cutpuot, the seccnd byte of the randem address field 
contains the ségment ard point number to be written to. Pata is 
written until the buffer specified ty the starting and endirg 
address is exhausted. 


STfTuS | MEANING 
oa ee wee oe | oR OREO DES SMEAR SERS SOEs Sewn Dw awa SEne Sane a 
X*co® | Necrmal ccrgeletion 

X*?0° | Levice unavailable . 

x*co* | Iliegal fenction; an ASCII oreraticn was 

| attempted 
X* ey? } Timeout 
xX "62" | Data transfer errcrs a nonexistent segment 


was selected 


5-16 CCNVEFRSION EQUIPMENT 


The analog conversicn equipment used with Perkin-Flmer 32-rit 
computers cannct be programmed in the device inderendent manner 
of cther peripheral devices. The chassis, channel and card 
addresses, and data values are directly passed to the real time 
analog system centroller as 16-rit werds as they are cbhtained 
from the usSere 


During ingut, the randcna address field cf the SVC 1 =farameter 
block contains the starting address of a table containing 
analog-to-digital converter addresses (chassis address, channel 
address, and card address). The user buffer, which the start and 
end addresses of the parameter blicck determine, is leaded with 
the diyitized data crkrtained frer these analog-to-digital 
converters. 


The table length containing the ccnverter addresses, is egual tec 
the length of the tEvtfer.e. Tt is the user’s resrensikbility to 
provide valid addresses. Since the analog input system mode cf 
the controller is used for PF?®lr, if a nonexistent chassis is 
addressed, zero data is stored and ro other indication is given. 


During cutbput, the user buffer is assumed te ccntain sequential 
pairs cf alternating digital-tc-analcg ccnverter addresses and 
the corresgcnding data to ke converted; ieee, ALDI, DATA, ADL, 
DATA2,eceecvevesvAlEn, DATAn. 
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The address and data are directly passed to the real time analcg 
system controller. 


The control outzgut mode of the ceontroller is used for write 
operaticnse if a nenexistent chassis is addressed, tha status is 
set to xX*°643°, and the remainder of the I/© is atorted. 


Each write sequence to any converter must consist of two 
halfwords. One halfword specifies the adapter tec de the 
conversion; the cther halfwerd ccentains the data to be ccnverted. 
Thus, any attenrct te do a write, with a huffer not a multiple cf 
two halfwords in lengta, results in a memory fault. 


For read and write ofeéerations, ASCII/binary and image/fcrmat 
requests are identical. 


STATUS | MEANING 
Ko" Nermal completion 

x" CCG* dllegal functicn ccde 
X°AC* Device unavailable 


| 
| 
| 
X* su" | Unrecoveretle errcer (hardware) 
| 
| 
| 


X*62° Recoverable error; timeout (priority 
tec lcw) 

X* BE Nonexistent chassis addressed cn write 

X*9c° Cut of SYNC (rrivrity too low) 


5217 ANALOG INFUT CONTFCLLER 


Variable record lenyths are surported by the Perkin-Flmer analcg 
input controller. A=CII cperaticns are net supported. Cemmand 
functions are ignored. 


The random address field cf the supervisor call 1 (SVC 1) 
parameter klock ccntains the gain and address of the first 
channel to te sampled. The fermat is shown in Figure 5-1. 
Dividing the length cf the user buffer CEXP-STERT+1) Ly two 
determines tne number cf channels to sample. The digitized data 
is sequentially stored in tke user tuffer, one halfword ger 
channel. 


| cai | | Address jf 


a ea eee ew wwe waeeenhe @ wee BF @we @ 2Getea @Feee wees ees we Se & Be ee eae aw 


Figure 5-1 Random Field Fcermat 
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HEANING 


| 
| 
| Ncrmal conpleticon 
{| Illegal function code 

X* AO * | Device unavailable 
| Recoverable error; device timeout 
| Unrecoverakle device error (device 
| wunavailarle durirg transfer) 
| Incorrect address alignment (START 
| address cdd, END address even) 


The driver accerts cnly random calis, meaning that the first 
address is selected at randcm and that further addresses are 
sequential (in the same call). The start address must te cn an 
even address kroundary and the END address must he cn an cdd 
address toundary, since the analog input controller is a halfwcerd 
device. This ccmplies with Instrument Society cf America (CISA) 
definition cf sequential analog inrut. 


5.18 ANALOG OUTPUT CONTROLLER 


All command functions are ignored Ey the Perkin-Flmer analcg 
Ooutrut controller. cne halfword cf data is obtained frem the 
user buffer in the format specified in Figure 5-2 and written to 
the device for conversicn.e This rprecedure is repeated until all 
halfwords in the user brffer are cutpute. Dividing tke length cf 
the user kufrer (ENL-START+1) by two computes the number cf 
halfwords tc be cutgut. 


wer ene ee ewe Oe es Se SO wwes Sew Ow OS SS Oe OS Ow Sw Oe eS oe @ 


Figure 5-z Analog Output Data Format 


STATUS | MEANING 
| Ncrmal completion 
X°CO" | Tllegal function 
| Incorrect address alionment (start address 
j cdd, end address even) 


Binary image is treated identically to binary fcrmat; the image 
bit is igncred. The sequential/randem bit is aiso igncred. Tke 
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Start address must ke aligned cn an even houndary: whereas, the 
end address must be on an cdd ktoundary because the analegdq cutrut 
controller is a halfword device. 


5-19 DIGITAL I/O CCNTRCLLER 


All command tunctions are ignored hy the Ferkin-Elmer digital 1/0 
controller. The number cf transfers is computed using the start 
and end address fields: (CENT-START+1)/2. Pesetting the 
sequential/randcm bit in the furctien code field causes transfers 
to occtr repeatedly, withcut “interrupticn. This is a 
nonhandshaking transfer modee In the handshaking transfer mode, 
the seguential/randem Fit is set, and each transfer occurs cnly 
atter the internal strete line is rulsed. A timeout rate fcr 
each transfer is sét at a censtant cf four seccnds. 


During each binary read creeraticn, the start address of the f£VC 
1 instruction yroints tc a hrffer that sequentially stcres cne 
halfword cf data from the digital inrut card. 


During tinary write operaticns, the start address points tc a 
buffer (K1) of halftwords ccnsisting of image halfwords fer cutreut 
transfer. The random eddress field of the SVC 1 parameter bicck 
points to another buffer (K2) of halfwords designating masks that 
define what correspcnding Lit pesition in K1 is to be changed. 
The Llencth cf KZ must be the same as that of K1. A bit set in kK2 
indicates that the digital outrut is changed tc the state defined 
by the corresgending tit fosition in K1.e- The following lcgical 
expression computes the halfxerds transferred to the digital 
Output card: 


Wheres: 


e Weans lcgical ANT; 

+ means logical Ok; 

K2 means one’s Complement of K23 

R is the last known content of the cutput register. 


STATUS | MEANING 
wore cane e| om en= ae @eeea@ @ @& aowmwee @ ew BSB Se eee Bee we Se & @ een @ ana = 
X*CO* | Nermal ccrpletion 
X*COo* Illegal function 
X* 20° Levice unavailable 
X*e@2° kKecoverakle error; tirecut 


during transfer 
Incorrect address alignment (start address odd, 
end address even, rardcm address odd). 


| 

| 
X*eu* | Unreccverakle errcr; device unavailable occurred 

| 

X*e6* | 

| 
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Binary image is treated identically to Linary fcrmrat; the drive 
ignores the formatted/image bit of the SVC 1 function code. The 
input ard output Sides are used in either the handskaking c¢r 
nonhandshaking transfer mcdes. The start and random addresses 
must be aligned on the even boundaries; whereas, the end address 
must be aligned cn an cdd kcundary hecause the digital I/0 
controljer is a halfword dévice. 


in 
‘ 
N) 
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APPENDIX A 
05/32 SUPPORTED I/0 LEVICES 


— ee ee eee ee ee ee ee ee eee ee ee ee eee ee oe me ee ee eee ee ee eee ee ee ee ee ee se ee ee ee ee es ew 
Re Se ee ee Se ee ee es se ee ee ee ee eT ee TS eS _ 


Qulprent j reader | 


| 
| reader | } 


Kigh speed card | | | 
} veaderspunach | J} [x 


| High speed cari | 
|} vceader/spunch w/ | 
| Separate print | 
| | 


Téeletyre [| Medel 33. * | ixtxf TxIlx?t |] 
(TTY) | momo ter tet cce-- ee me mnt wen nn em en men ween tere cen: 
reader/ | “scedel 2f * | Ix{x] Ex?x] | f 
punch J mow reer w eer mee Te ee me men meee eee See teem een—en: 
| Carcus2z] 35 wath | | 
{ paper tape | | 
| { | 
| | | 


reader 132-char- 
acter line 
Teletype | Mcdel 35 f “46-OCG/2/4/5 I|x][x}] | fxd fo fd: 
Tio rn rn tnt meee meee ccees 
keyboard | Model 35 | ¥46-0C01/73 Ixtxf | fxd Fo odo 
printer [SSeS ee Sec ee esa SoS eae eae Se Se ee Sere SS ae eae es 
Ferkin-Filner Car- 1 MUE-01C/1/5/6 
35, 13Z-character | 
line * | 


} Ferkin-Flmer Car- 

f cugel * 15, 3¢% 

j 35, 8$U0echaracter 
} dine * 

Paper tape | Fapyer tare reader/ | FMU6-242/3 id 

aquignrent { punch { Ix] x] 


oe ee ee ee eee ee ee ee ee ees ee eee ee ee ee ee ee ee eee Oe ee 
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ane wee ew een ewwe weer as SB eee ww ewwraes ee BPS ee FTF eB SPS SSP eerwae = wf 2 eee & 


Low speed line 


| 

| . 

| | printer: Pixt | tel Prd 
| aap iene ras orc ereatadramiar be eee nets ge en ee Sign SS | 
r | Character printer MUGB—$221/2/3/4 | Ixf f txt TP tt | 
| [SSS ioe ia ee a re ae at ere ry eee een Se i 
| } Sedium speed line "HE=300/1/2Z/37 | | | | | ld ddd 
| | printers 4/5/6/7 Ptixt t txt Pt tbl 
| (occa aaa oer gs RS PLL Bas ae mae 
| j High sreed line Prrrtrtrbrtaidil 
| | printer Pixt tT txt db 
| areteis cin ws atatn cine meneame oamelnoneeaptaeeriaiscEnaE carci 
| | Thermal gage M46-06E/8/and {| | | | ttl ddd 
i | pranters mu6-080/2 1 txt t txt | bt 
[PS 2es coe a a em sc a a aca aa ha beak alas =se 
| Tape | Intertarce MHE-4OC Ixtx? Ex}xd dxdt | f 
| Cassette | Prd rd? tail de 
Eatetatntetelneetetetatateetenttedeietetetanetanetatenetanenatanceheanaieneasetaientaiaranetaten tae enn aenn- <2 aos | 
{| tagnetic | 80%kpi Ixfxt txtxd Gxt dol 
| tape estat ioral een aan eens maa ie orl el aa cn aon o-| 
| | 1600br3 PxPx] Pxtxd (xl | | 
| i ata a ae aaa ae | 
| | 625Gbpi Ixtxf Uxtxt xt td 
| Peron is ae a Sa a ma ae saan 
| {| 9-track, 75S-ins, ™UE-4I0/2 Prtrrtrdd@ t td 
| {| 80C-bri Ixtxf Uxtxd txt tf 
| letetetehetateaichstatetatatetetatenarateiareieteranerate owner necen conn nena conn nnn| 
| {| S-tracax, 4S5-ips, “UG-494/6 Prirtd?tttidd 
| | 8CC/16CC-bgEi Ixtxf Txtxt txt tol 
| Totatelaistapeiatetapeneeaanenana NED eeetaoRpEptaneamneearrtans cn ene nena ooo-| 
| { 80v-bpi Ixtxt txtxd txt ff 
| ROT Cie ia re ae ee ee ee eee ene rages 
| { Q-track, 45-ics, ¥UE=$515/16 ;rtdletdbt du 
| J} 16CO-bri IxIx] Ixixf Ext tl 
ea a a aca am aa ae aout. 
| Discs } Z2.5%b remcvable Pr td t bade bd bet 
| | disk IxlxIxtxixtxf | df 
| Le Se (ae ee een ne Bie et a ee me et eee oe ee 
| | 10Mk disk systen Plaidrttdidddtd 
| | (5b fixed, 5 Mb Pir? ttidtt dd 
| | vcemovakle) IxPx{xtxtxix! Pod if 
| [Gessbobelimiateneesa stasatare anaes cian a atcuses eauaen atstesaneraner eterna | 
| 67Nb disk IxIxixtxtxtxt Polo 
PT APES ee ae ee Se Se ee ee SHerenere | 
| | 256Mb disk [xf xtxtxtxtxf | odo f 
| eeeiehr dager tcameiiaca aus acme aah gic is eeae BSoees | 
| {| 68.64b disk Ix{xlxixtxixt Pod 
| Ne eee cae apes mein aan aig eee ee ae a-nn=- | 
| | MSH 300 disk sys- PrilYyrrttetddil 
| {| tem (3CO%E drive ribtdtdl dt 
| } and certreller) Ixfxfxtxtxtxt | 
| ears ogieie nae aa REE amar wan nen n nnn nnn nnn n nnn nn 
] | HSM 89 disk systenr MUE=600/2 rr’qartl!ddbadttl 
| } (80M%b drive and P'rdidtd?d ddd dt 
| contreller ix{xtxtxtxixt | tol 
he? 48-040 FOO 9/281 


ee cee cee ore Gee are Ge geen 


ee eee me ee ge ems SES ae eure cum ee cue come OE eee ee ee Oe eee ee OE gee ee ee eee eee ee ee eee eee eee eee eee Oe eee ee eee coe eee cee oe eee eee SE Gee ae oe 
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Video dis- 
Dliay wunits 
(VDU) 


Beeline 
interrust 
module 


Digital 
multirlexcr 


Conversion 
equipment 


Analcg 1/C 
contrcller 


MSM BOF disx 1 MU6-691/2 Piertrtt=tdd 
system | IxJxixlxtxdxl | 
MS4 SOF/HPT disk | Fué-693/4 Patt td dl 
Systen | Ixfxixdxlx xl | 
Vanguard 1 cart- | ™46-710/11 fftdrdbtti 
ridge disk system | Ix? xixtxtx]x] | 
Nonediting VDU ¢% | Ixtxf | txt to ix 
Graphic display | frrtrridd 
terminals $ * | Ix?txl | txt ft ix 
Carcuse1] 390 * § { Ixfx] | txt 7 ix 
Carecuse] 3¢°0 with | rPitttrdd dd 
électrenic format | ;rrrtdld dt do 
contrels | Ix!xl f yxt | tx 
Model 1200 VDU | {xtxf | |xd f ix 
model 1100 VDU ¢™* | Ixtxf T txt ft tx 
Model 5£0 } 4U6-11-/111/ Ixtx] | [xf | x 
1 112/113/114 Prd ttl | 

“Yodel 1250 1} “46-121/2/3/4/ |x{x] | |x] | ix 
| 15/6 Py der tded 

Model 1251 1 M46-47/8/9/and {xtx] | fx |x 
1 60/51/52 Py treet | 
Florpy disk | “UG }xfx] (xtxix] | 
Reline interrurt | “ue-0014 Phiak Te bebe 
modul- | Ix} | tt dbo 
{ es ee ee | 
Cigital multiplex- | ¥C7-26C iD (ee ae (cae ee ae ee | 
or contrcller | xxl TxIxdxft | 
Realtime analoa } *49-€03 r?rtttdtd 
system with user | ;rtdrdteel 
supplied extern- | tf) trdetl 
al clecck ] Ixtxf Exix? qd 
Realtime analog | MUB-6023 ftddtitaudd 
system with user | ftlritt td 
supplied external | frtrttt dud 
clock | Ixtx} Pxixd dof 
Mini I/C ingut [| Mu8-212/3/4/5 {xl IT txtxixt | 
Mini I/C cutput { Mae-3S53/4/75F { txt Yxdxdxtd 4 
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| 
{ D 
i. 


aw we OO BEE ww BB enews Bese ee wee Be KB DWH KF Sw eOe@e OSB Fee esas s2saeee wees 2G Oe 2 @ we we 


> * 


vu} 


igital I7O0 | Mini I/C Mcdule | MaQe-u5C Ixtx] Pxtx]x 
ridertl 


ontrecller | | 


LECENT 


CLI - Current Locp Irterface 
CLCM - Current Leon Communications Multirlexcr 
RS232zC 1 


ETTRiBUTES 
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Devices listed without a product number 
ace no longer marketed ry Ferkin-Flmrer. 
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